Discogs Vinyl & Music Marketplace Scraper

Extract vinyl records, CDs, and music release data from Discogs — the world's largest music database and marketplace with 17M+ releases, 9M+ listings, and prices for every pressing.

Uses Discogs' public REST API. No scraping, no proxies — clean structured JSON from the official API.

---

🎵 What does it do?

Queries the Discogs database and marketplace to collect release metadata, pressing details, community demand metrics, and live marketplace prices. Supports five modes covering the full Discogs catalog.

Use cases:

• Price arbitrage — find underpriced vinyl listings across genres and regions
• Collection valuation — bulk-fetch current prices for a list of release IDs
• Market research — track demand (have/want counts) for specific pressings
• Label analytics — scrape full catalogs for a record label
• Artist discography — complete release history for any artist
• Price history — lowest prices and availability for any release
• Record shop inventory — enrich product listings with Discogs metadata

---

📦 Output fields

Release / Search record

Field	Description	Example
releaseId	Discogs release ID	249504
title	Album/release title	"The Dark Side of the Moon"
artists	Artist objects array	[{name: "Pink Floyd"}]
artistsStr	Artists as string	"Pink Floyd"
labels	Label objects array	[{name: "Harvest", catno: "SHVL 804"}]
labelsStr	Labels as string	"Harvest"
formats	Format objects	[{name: "Vinyl", descriptions: ["LP", "Album"]}]
formatsStr	Formats as string	"Vinyl"
genres	Music genres	["Rock"]
styles	Music styles	["Psychedelic Rock", "Progressive Rock"]
year	Release year	1973
country	Pressing country	"UK"
have	Community have count	150420
want	Community want count	38210
ratingAvg	Community rating (1-5)	4.72
ratingCount	Number of ratings	42311
lowestPrice	Lowest marketplace price (USD)	12.50
numForSale	Active marketplace listings	842
barcode	Barcode / matrix number	"5099902987323"
tracklist	Track listing array	[{position: "A1", title: "Speak to Me"}]
thumb	Thumbnail image URL	"https://i.discogs.com/..."
url	Discogs release URL	"https://www.discogs.com/release/249504"

Marketplace listing record

Field	Description	Example
listingId	Listing ID	1234567890
releaseId	Associated release ID	249504
price	Listing price	24.99
currency	Price currency	"USD"
condition	Overall condition	"Near Mint (NM or M-)"
mediaCondition	Vinyl/disc condition	"Very Good Plus (VG+)"
sleeveCondition	Sleeve condition	"Very Good (VG)"
sellerUsername	Seller's username	"recordshop_berlin"
sellerRating	Seller rating (%)	99.8
sellerSales	Total seller sales	4521
shipsFrom	Ships from country	"Germany"
allowOffers	Accepts offers	true

---

⚙️ Modes

search — Search the Discogs database

{
  "mode": "search",
  "query": "Miles Davis",
  "format": "vinyl",
  "genre": "Jazz",
  "year": "1959",
  "maxResults": 100
}

releases — Fetch specific releases by ID

{
  "mode": "releases",
  "releaseIds": [249504, 1174403, 870507],
  "fetchReleaseDetails": true
}

marketplace — Get live marketplace listings

{
  "mode": "marketplace",
  "releaseIds": [249504],
  "condition": "Near Mint (NM or M-)",
  "maxResults": 50
}

artist — Full artist discography

{
  "mode": "artist",
  "artistId": 45467,
  "maxResults": 0
}

label — All releases for a label

{
  "mode": "label",
  "labelId": 1,
  "maxResults": 200
}

---

💡 Popular IDs

Release	ID
Pink Floyd – Dark Side of the Moon	249504
Miles Davis – Kind of Blue	1174403
The Beatles – Abbey Road	870507
Nirvana – Nevermind	362393
Michael Jackson – Thriller	268374

Artist	ID
Pink Floyd	45467
The Beatles	82730
Miles Davis	119139

Label	ID
Blue Note Records	1
Sub Pop	5
Warp Records	23528

---

📊 Output example

{
  "releaseId": 249504,
  "title": "The Dark Side Of The Moon",
  "artistsStr": "Pink Floyd",
  "labelsStr": "Harvest",
  "formatsStr": "Vinyl",
  "genres": ["Rock"],
  "styles": ["Psychedelic Rock", "Progressive Rock"],
  "year": 1973,
  "country": "UK",
  "have": 150420,
  "want": 38210,
  "ratingAvg": 4.72,
  "lowestPrice": 12.50,
  "numForSale": 842,
  "url": "https://www.discogs.com/release/249504",
  "scrapedAt": "2026-03-16T08:00:00.000Z"
}

---

💰 Pricing

Volume	Estimated cost
100 releases	~$0.50
500 releases	~$2.50
1,000 marketplace listings	~$5.00

Tier	Price per result
Default	$0.005
Bronze	$0.0045
Silver	$0.004
Gold	$0.0035

---

⚡ Performance & Rate Limits

• No proxy needed — official Discogs API, clean JSON responses
• Rate limit: 60 requests/minute (anonymous or with personal token)
• Personal token — free from discogs.com/settings/developers, same rate limit but more reliable
• Automatic rate limiting built in — the actor paces requests to stay within limits

---

❓ FAQ

Do I need a Discogs account? No. The API works without authentication. Adding a free personal token (discogsToken) improves reliability.

Where do I find release/artist/label IDs? In the Discogs URL: discogs.com/release/249504 → 249504, discogs.com/artist/45467 → 45467

What is have and want? Community collectors who own (have) or are looking for (want) a release. High want/have ratio = high demand = often higher prices.

Can I get price history? Yes — use mode=marketplace with a release ID to get all current listings sorted by price.

What is fetchReleaseDetails? In search mode, by default only basic fields are returned. With fetchReleaseDetails: true, the actor fetches each release's full page for tracklists, community ratings, and full pressing details. Slower but much richer data.