Discogs

💿 Search Discogs without copying pages by hand

Discogs is for record collectors, sellers, music researchers, and developers. Search public Discogs vinyl records, CDs, artists, labels, and master releases, or look up a known release. Get catalog details, cover links, community data, marketplace offers, and current asking prices without a Discogs login.

Use it to:

• Find CDs and their catalog details with Discogs CD.
• Search for releases and marketplace data with Discogs Vinyl Records.
• Find vinyl by artist, title, label, or other words with Discogs Vinyl.
• Find record label profiles with Discogs Label Search.
• Find musician and group profiles with Discogs Artist Search.
• Export current offers and asking prices with Discogs Marketplace Prices.
• Find releases by name or keyword with Discogs Release Search.
• Build a current asking-price guide with Discogs Vinyl Record Price Guide.
• Check current availability and lowest asking price with Discogs Vinyl Value.
• Collect public catalog data with Discogs Scraper.

📦 Data you get

The Actor saves five row types: releases, artists, labels, master releases, and marketplace offers. Release rows can include IDs, artists, dates, labels, formats, covers, barcodes, matrix and runout values, tracklists, credits, community counts, and marketplace summaries. Marketplace rows can include asking price, media and sleeve condition, seller details, shipping origin, shipping cost, and an offer link.

A field may be missing when Discogs does not show it. When searches overlap, the first eligible match is saved. Later matches for the same Discogs resource are skipped.

🚀 Run the Actor

1. Choose one Target.
2. Add names or keywords, or add known release URLs or IDs.
3. Add release filters if you chose Release search.
4. Set a result limit, or leave it empty to get all available results until Discogs is exhausted.
5. Run the Actor and open the dataset.

No Discogs API key, account, or login is needed.

🛠️ Input

Field	Type	What it does
target	string	Chooses Release search, Release details, Artist search, Label search, Master release search, or Marketplace listings.
searchValues	array of strings	Names or keywords for release, artist, label, and master release searches.
releaseValues	array of strings	Discogs release URLs or numeric IDs for release details and marketplace listings.
maxItems	integer	Stops after this many search results or marketplace offers. Leave it empty to get all available results until Discogs is exhausted.
releaseSearchOptions	object	Holds the optional Release search filters below. Empty filters match any value.
releaseSearchOptions.yearFrom	integer	Keeps releases from this year or later.
releaseSearchOptions.yearTo	integer	Keeps releases from this year or earlier.
releaseSearchOptions.country	string	Matches a release country, such as US.
releaseSearchOptions.genre	string	Matches a genre, such as Jazz.
releaseSearchOptions.style	string	Matches a music style.
releaseSearchOptions.format	string	Matches a format, such as Vinyl or CD.
releaseSearchOptions.label	string	Matches a record label.

The successful default-input run used:

{
  "target": "releaseDetails",
  "releaseSearchOptions": {
    "yearFrom": 1959,
    "yearTo": 1959,
    "country": "US",
    "genre": "Jazz",
    "format": "Vinyl"
  },
  "releaseValues": [
    "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up"
  ],
  "maxItems": 10
}

Only fields for the chosen target are used.

📄 Output

Release rows

Field	Type	What it does
rowType	string	Always release.
id	integer	Discogs release ID.
title	string	Release title.
url	string	Public Discogs release page.
searchValue	string	Input value that first found the release.
artists[].id	integer	Discogs artist ID.
artists[].name	string	Artist name.
artists[].url	string	Public artist page.
releaseDate	string	Date shown by Discogs.
year	integer	Release year.
country	string	Release country.
genres[]	array of strings	Music genres.
styles[]	array of strings	Music styles.
labels[].id	integer	Discogs label ID.
labels[].name	string	Label name.
labels[].catalogNumber	string	Catalog number.
formats[].name	string	Format name.
formats[].quantity	integer	Number of items in the format.
formats[].descriptions[]	array of strings	More format details.
coverImageUrl	string	Main cover image link.
thumbnailUrl	string	Small cover image link.
identifiers[].type	string	Identifier type, such as Barcode or Matrix / Runout.
identifiers[].value	string	Identifier value.
identifiers[].description	string	More identifier detail.
tracklist[].position	string	Track position.
tracklist[].title	string	Track title.
tracklist[].duration	string	Track length shown by Discogs.
tracklist[].artists[]	array of strings	Artists named for the track.
tracklist[].mediaUrls[]	array of strings	Media preview links for the track.
notes	string	Published release notes.
mediaPreviewUrls[]	array of strings	Published media preview links.
credits[].id	integer	Discogs ID for a credited person.
credits[].name	string	Credited name.
credits[].roles[]	array of strings	Credited roles.
companies[].id	integer	Discogs company ID.
companies[].name	string	Company name.
companies[].role	string	What the company did.
companies[].catalogNumber	string	Company catalog number.
community.haveCount	integer	Users who say they own the release.
community.wantCount	integer	Users who want the release.
community.rating	number	Average user rating.
community.ratingCount	integer	Number of user ratings.
community.status	string	Discogs catalog status.
community.dataQuality	string	Discogs data quality grade.
marketplace.available	boolean	Whether an offer is for sale.
marketplace.listingCount	integer	Number of current offers.
marketplace.lowestPrice	number	Lowest current asking price.
marketplace.currency	string	Currency code for that price.

A full release row from the current beta build:

{
  "rowType": "release",
  "id": 249504,
  "title": "Never Gonna Give You Up",
  "url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
  "artists": [
    {
      "id": 72872,
      "name": "Rick Astley",
      "url": "https://www.discogs.com/artist/72872"
    }
  ],
  "releaseDate": "1987-07-00",
  "year": 1987,
  "country": "UK",
  "genres": [
    "Electronic",
    "Pop"
  ],
  "styles": [
    "Euro-Disco"
  ],
  "labels": [
    {
      "id": 895,
      "name": "RCA",
      "catalogNumber": "PB 41447"
    }
  ],
  "formats": [
    {
      "name": "Vinyl",
      "quantity": 1,
      "descriptions": [
        "7\"",
        "45 RPM",
        "Single",
        "Stereo"
      ]
    }
  ],
  "coverImageUrl": "https://i.discogs.com/-DPFA5hKT8i91jnjn4rLB1zSiuUBFTrGWspu1TpLV30/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI0OTUw/NC0xMzM0NTkyMjEy/LmpwZWc.jpeg",
  "thumbnailUrl": "https://i.discogs.com/HG2xChKN-rIHHSfgL53W9z2vJWeFknfevpOMwSHtIaM/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI0OTUw/NC0xMzM0NTkyMjEy/LmpwZWc.jpeg",
  "identifiers": [
    {
      "type": "Barcode",
      "value": "5012394144777"
    },
    {
      "type": "Label Code",
      "value": "LC 0316"
    },
    {
      "type": "Price Code",
      "value": "AC",
      "description": "D:"
    },
    {
      "type": "Price Code",
      "value": "RC110",
      "description": "F:"
    },
    {
      "type": "Price Code",
      "value": "AA",
      "description": "UK:"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 A‡",
      "description": "A side label"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 B‡",
      "description": "B side label"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 A2 UTOPIA MS",
      "description": "A side runout, variant 1"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447-B.2 UTOPIA MS",
      "description": "B side runout, variant 1"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 A4 UTOPIA MS.",
      "description": "A side runout, variant 2"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 B4 UTOPIA MS ♥ RD.",
      "description": "B side runout, variant 2"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447 A2 UTOPIA MS B",
      "description": "A side runout, variant 3"
    },
    {
      "type": "Matrix / Runout",
      "value": "PB 41447-B.2 B UTOPIA MS",
      "description": "B side runout, variant 3"
    }
  ],
  "tracklist": [
    {
      "position": "A",
      "title": "Never Gonna Give You Up",
      "duration": "3:32",
      "artists": []
    },
    {
      "position": "B",
      "title": "Never Gonna Give You Up (Instrumental)",
      "duration": "3:30",
      "artists": []
    }
  ],
  "credits": [
    {
      "id": 547352,
      "name": "Me Company",
      "roles": [
        "Design"
      ]
    },
    {
      "id": 78275,
      "name": "Mark McGuire",
      "roles": [
        "Engineer"
      ]
    },
    {
      "id": 95941,
      "name": "Mike Duffy",
      "roles": [
        "Engineer"
      ]
    },
    {
      "id": 383408,
      "name": "Miles Showell",
      "roles": [
        "Lacquer Cut By"
      ]
    },
    {
      "id": 34067,
      "name": "Pete Hammond",
      "roles": [
        "Mixed By"
      ]
    },
    {
      "id": 20942,
      "name": "Stock, Aitken & Waterman",
      "roles": [
        "Producer",
        "Written-By"
      ]
    }
  ],
  "companies": [
    {
      "id": 82835,
      "name": "BMG Records (UK) Ltd.",
      "role": "Phonographic Copyright (p)"
    },
    {
      "id": 82835,
      "name": "BMG Records (UK) Ltd.",
      "role": "Copyright (c)"
    },
    {
      "id": 301937,
      "name": "Pete Waterman Ltd.",
      "role": "Phonographic Copyright (p)"
    },
    {
      "id": 273945,
      "name": "All Boys Music Ltd.",
      "role": "Published By"
    },
    {
      "id": 26385,
      "name": "BMG Records",
      "role": "Distributed By"
    },
    {
      "id": 33652,
      "name": "BMG Ariola",
      "role": "Distributed By"
    },
    {
      "id": 29656,
      "name": "RCA Records",
      "role": "Marketed By"
    },
    {
      "id": 266218,
      "name": "Utopia Studios",
      "role": "Lacquer Cut At"
    },
    {
      "id": 82835,
      "name": "BMG Records (UK) Ltd.",
      "role": "Licensed To"
    },
    {
      "id": 30024,
      "name": "PWL",
      "role": "Record Company"
    },
    {
      "id": 553982,
      "name": "CBS Pressing Plant, Aston Clinton",
      "role": "Pressed By"
    }
  ],
  "notes": "UK Release has a black label with the text \"Manufactured In England\" printed on it.\n\nSleeve:\n℗ 1987 • BMG Records (UK) Ltd. © 1987 • BMG Records (UK) Ltd.\nDistributed in the UK by BMG Records •  Distribué en Europe par BMG/Ariola • Vertrieb en Europa dürch BMG/Ariola.\n\nCenter labels:\n℗ 1987 Pete Waterman Ltd.\nOriginal Sound Recording made by PWL.\nBMG Records (UK) Ltd. are the exclusive licensees for the world.\n\nDurations do not appear on the release.\n\nRunouts are etched, except 'B' stamp in variant '3. 'MS' is encircled. ",
  "mediaPreviewUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://www.youtube.com/watch?v=nsCIeklgp1M",
    "https://www.youtube.com/watch?v=5SZYz7lZRRI",
    "https://www.youtube.com/watch?v=7FwDP17XPlk",
    "https://www.youtube.com/watch?v=OWGRrOo7l5E",
    "https://www.youtube.com/watch?v=9-t0P3dqRD0",
    "https://www.youtube.com/watch?v=hIWRq2SJUmg",
    "https://www.youtube.com/watch?v=n3jMY98KIEw",
    "https://www.youtube.com/watch?v=ENVqkACcR0c",
    "https://www.youtube.com/watch?v=_QSx57P9gwE",
    "https://www.youtube.com/watch?v=BnoMXGVDC4w",
    "https://www.youtube.com/watch?v=iPm1ltTM5-w",
    "https://www.youtube.com/watch?v=6EWB1ObTbD4"
  ],
  "community": {
    "haveCount": 4083,
    "wantCount": 579,
    "rating": 3.84,
    "ratingCount": 235,
    "status": "Accepted",
    "dataQuality": "Correct"
  },
  "marketplace": {
    "available": true,
    "listingCount": 123,
    "lowestPrice": 0.62,
    "currency": "USD"
  }
}

Artist and label rows

Artist and label rows have the same fields. Their rowType and ID meaning differ.

Field	Type	What it does
rowType	string	artist or label.
id	integer	Discogs artist or label ID.
name	string	Artist or label name.
url	string	Public Discogs page.
searchValue	string	Input value that first found it.
thumbnailUrl	string	Small profile image link.
profile	string	Profile text shown by Discogs.

{
  "rowType": "artist",
  "id": 23755,
  "name": "Miles Davis",
  "url": "https://www.discogs.com/artist/23755",
  "searchValue": "Miles Davis",
  "profile": "Trumpeter, bandleader, and composer\r\nBorn May 26, 1926 in Alton, Illinois, USA, died September 28, 1991 in Santa Monica, California, USA (aged 65)\r\n\r\nOne of the most important figures in jazz history, Davis adopted multiple musical directions in a five-decade career that kept him at the forefront of many major stylistic developments in jazz. His album \"[m=5460]\" (1959) is the highest selling jazz album ever with over five million copies sold.\r\n\r\nMiles settled in New York City to study at Juilliard School. He made his professional debut as a member of [a272028] from 1944 to 1948. In 1948, Davis began to found his own ensembles. At that time, he met [a255137], who contributed to [a497768]'s scores and arrangements. The dozen sides they recorded in 1949-50 were eventually assembled as the LP \"[m=62308]\" (1957), with Davis and Evans working together again from 1957 on further projects.\r\n\r\nMiles Davis was prominent in the creation of the 'Hard Bop' style in the mid-1950s (his first regular quintet featured [a97545]), and the \"time, no changes\" approach in his second quintet a decade later. In the late 1960s, he introduced electronic instruments and rock and funk rhythms in his music. Around 1975, he went on a hiatus over health and personal problems, re-emerging in 1980.\r\n\r\nHe married dancer/actress [a7671712] on December 12, 1959; the couple divorced in 1968. He then married singer [a1076460] in September 1968; they divorced in 1970. He then married actress [a6279083] on November 26, 1981; they divorced in 1989. Father of [a680784] and [a1493787]. Uncle of [a279708] (Jr).\r\n\r\nInducted into Rock And Roll Hall of Fame in 2006 (Performer).\r\n\r\nWinner of eight Grammy Awards:\r\n- Best Jazz Composition Of More Than Five Minutes Duration for Sketches Of Spain on [m=48172]\r\n- Best Jazz Performance - Large Group Or Soloist With Large Group for [m=8260]\r\n- Best Jazz Instrumental Performance, Soloist for [m=65130]\r\n- Best Jazz Instrumental Performance, Soloist for [m=63355]\r\n- Best Jazz Instrumental Performance, Big Band for [m=62288]\r\n- Best Jazz Instrumental Performance, Soloist (On A Jazz Recording) for [m=62288]\r\n- Best R&B Instrumental Performance for [m=62359]\r\n- Best Large Jazz Ensemble Performance for [m=188032]",
  "thumbnailUrl": "https://i.discogs.com/6RcjwMh_j_MfW-oanRWR0plRv4xrDUzYOPMsX-Df17c/rs:fit/g:sm/q:90/h:800/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9BLTIzNzU1LTE3NjI4NjQzNDkt/MjU4NC5qcGVn.jpeg"
}

{
  "rowType": "label",
  "id": 281,
  "name": "Blue Note",
  "url": "https://www.discogs.com/label/281",
  "searchValue": "Blue Note",
  "profile": "Blue Note is a label that is mostly known for its releases in the jazz genre.\r\n\r\nLabel Code: LC 0133 / LC 00133\r\n\r\nFounded by [a=Alfred Lion] and [a=Max Margulis] in 1939, the label was soon joined by Lion's childhood friend [a=Francis Wolff] (who took photographs during rehearsals used on LP sleeves). The early years saw BN issue 78rpm sides featuring traditional jazz artists and small-group swing, but from 1947 the company began to record the emerging bop movement with sides from [a=Thelonious Monk] and, in the next few years, [a=Bud Powell] and [a=Fats Navarro]. From the 1950s, Blue Note recorded musicians such as the Hammond organist [a=Jimmy Smith] and artists in the hard-bop idiom such as [a=Art Blakey & The Jazz Messengers]. Albums by long-time artists [a=Lee Morgan] (The Sidewinder)  and [a=Horace Silver] (Song For My Father) made a significant impact in the 1960s. Meanwhile, the label recorded more exploratory albums by  [a=Ornette Coleman] and [a=Cecil Taylor], among others\r\n\r\nLion sold the label to [l13531] in 1965 and retired in 1967. Wolff died in 1971. By now, more commercially-oriented music, including jazz-fusion, had started to be issued on the label, but in 1975, then-owners [l4898] launched a reissue program of Blue Note's back catalog which lasted until 1980. The previous year, Blue Note became a label of [l654].\r\n\r\nBeginning in 1982, Blue Note sessions began appearing in box-sets from [l100901] (co-owned by [a=Michael Cuscuna]). The label itself was relaunched as part of Capitol  subsidiary [l85486] in 1985 and began making new recordings, re-releasing albums and previously unissued material from the Lion-Wolff era found by Cuscuna.\r\n\r\nIn 1989, [l85486] was discontinued and Blue Note became the division under which all of Capitol-EMI's jazz activities were organized (two years later, [l85486] was revived for smooth jazz and pop-jazz releases). \r\n\r\nA 2005 reorganization at both [l654] and parent company [l26126] put Blue Note along with sister labels [l85486], Angel, Virgin Classics and Metro Blue under the Blue Note Label Group umbrella covering jazz, classical and adult pop recordings.\r\n\r\nIn 2012, [a62920] succeeded [a1120514] as Blue Note's president, and the label's owner, [l26126], was purchased by the [l38404].\r\n\r\nPlease note, many Blue Note issues also carry an [l26126] logo. This is not a label and [l=EMI] should not be added as a label. Instead it indicates that Blue Note was part of the EMI Group.\r\n\r\nBlue Note® is a registered trademark of [l87317]",
  "thumbnailUrl": "https://i.discogs.com/3HpIGTTfcLBKDF0WKsdSygbdfgirR7shFM3kGhgArBI/rs:fit/g:sm/q:90/h:598/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9MLTI4MS0x/NTAyNjQwNjY3LTQ4/MzMucG5n.jpeg"
}

Master release rows

Field	Type	What it does
rowType	string	Always master.
id	integer	Discogs master release ID.
title	string	Master release title.
url	string	Public master release page.
searchValue	string	Input value that first found it.
artists[]	array of strings	Artists named on the master release.
year	integer	First release year.
genres[]	array of strings	Genres.
styles[]	array of strings	Styles.
coverImageUrl	string	Main cover image link.
thumbnailUrl	string	Small cover image link.

{
  "rowType": "master",
  "id": 5460,
  "title": "Kind Of Blue",
  "url": "https://www.discogs.com/master/5460-Miles-Davis-Kind-Of-Blue",
  "searchValue": "Kind of Blue",
  "artists": [
    "Miles Davis"
  ],
  "year": 1959,
  "genres": [
    "Jazz"
  ],
  "styles": [
    "Modal"
  ],
  "coverImageUrl": "https://i.discogs.com/dc6vUf2t2zFHMdwvlfI9Pr1dVBUGBrEp4QCKboA-URk/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTYyNzYx/ODMtMTQxNTM4NjM4/Ni04Nzc5LmpwZWc.jpeg",
  "thumbnailUrl": "https://i.discogs.com/skkwNfLHyVfglZzycz3Txp8maLAFkHo70SJihiFBJzc/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTYyNzYx/ODMtMTQxNTM4NjM4/Ni04MjAzLmpwZWc.jpeg"
}

Marketplace offer rows

Field	Type	What it does
rowType	string	Always marketplaceListing.
id	integer	Discogs listing ID.
releaseId	integer	Discogs ID of the release for sale.
releaseTitle	string	Release title.
offerUrl	string	Public offer page.
price.value	number	Seller's asking price.
price.currency	string	Asking-price currency code.
mediaCondition	string	Seller's media grade.
sleeveCondition	string	Seller's sleeve grade.
seller.name	string	Seller name.
seller.url	string	Public seller page.
seller.rating	number	Positive feedback rate.
seller.ratingCount	integer	Number of seller ratings.
shipsFrom	string	Country the offer ships from.
shippingPrice.value	number	Shown shipping cost.
shippingPrice.currency	string	Shipping currency code.

{
  "rowType": "marketplaceListing",
  "id": 4265397546,
  "releaseId": 249504,
  "releaseTitle": "Rick Astley - Never Gonna Give You Up (7\", Single)",
  "offerUrl": "https://www.discogs.com/sell/item/4265397546",
  "price": {
    "value": 0.35,
    "currency": "GBP"
  },
  "mediaCondition": "Very Good (VG)",
  "sleeveCondition": "Generic",
  "seller": {
    "name": "FunkyTownFamily",
    "url": "https://www.discogs.com/seller/FunkyTownFamily/profile",
    "rating": 99.8,
    "ratingCount": 3383
  },
  "shipsFrom": "United Kingdom",
  "shippingPrice": {
    "value": 24.5,
    "currency": "GBP"
  }
}

Open the dataset to export these rows or read them through the Apify API.

💳 Pricing

This Actor uses pay-per-event pricing. You are charged for each release, master release, artist, label, or marketplace offer saved to the dataset. An input that saves no row is not a charged outcome. Check the Pricing tab for the current rate.

🔌 Integrations

Use Apify schedules to run searches again. Send rows to webhooks or other Apify integrations, or read the dataset with the Apify API.

❓ FAQ

Is this the official Discogs Actor?

No. This is an independent Actor that reads public Discogs data.

Can it grade a vinyl record or CD?

No. It returns the media and sleeve grades written by marketplace sellers. It does not check a physical item or give its own grade.

Can I get sold-price history?

No. It returns current offers and marketplace summaries. It does not rebuild sold-price history or track price changes over time.

Does the lowest asking price show a record's true value?

No. It is the current lowest asking price shown by Discogs when available. It is not a sale price, appraisal, or promise of value.

Can I use private collections or wantlists?

No. The Actor reads public catalog and marketplace data. It does not open or change private account data.

What happens when two searches find the same release?

The first eligible match is saved. A later match for that release is skipped.

Can one run search different resource types?

No. Choose one target for each run. You can give that target several values.

Does the Actor download covers, audio, or video?

No. It can return public image and media preview links when available, but it does not download those files.

📝 Changelog

• 0.1: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• SoundCloud Scraper — collect public tracks, artists, playlists, albums, and comments for music research.
• YouTube Music Scraper — search public songs, albums, artists, playlists, podcasts, and profiles.
• Musescore Scraper — find public sheet music and score details for catalog research.
• Discogs.com Scraper — compare another tool for Discogs release and marketplace research.
• Spotify To Discogs Matcher — match Spotify playlist tracks to Discogs releases and vinyl versions.

Made with ❤️ by Maxime Dupré