Discogs Marketplace Vinyl Price Guide Scraper

Scrape marketplace pricing data for vinyl records and releases from Discogs. Returns current market stats (copies for sale, lowest price), per-condition price suggestions (Mint / NM / VG+ / VG / G), and collector demand signals (community have/want counts, rating). Powered by the official Discogs REST API — no Cloudflare-walled HTML scraping.

What you get

Each record in the output dataset represents one Discogs release with:

Field	Description
release_id	Discogs release ID
master_id	Master release ID (if applicable)
title	Release title
artists	Artist names (comma-separated)
year	Release year
country	Country of release
formats	Format details — e.g. "Vinyl LP Album 180 gram"
labels	Label names (comma-separated)
catno	Catalogue number
genres	Genres (comma-separated)
styles	Styles (comma-separated)
num_for_sale	Copies currently listed for sale on Discogs marketplace
lowest_price_value	Lowest marketplace listing price (numeric)
lowest_price_currency	Currency of the lowest price (e.g. USD)
price_suggestion_mint	Suggested price for Mint (M) condition
price_suggestion_near_mint	Suggested price for Near Mint (NM or M-) condition
price_suggestion_very_good_plus	Suggested price for Very Good Plus (VG+) condition
price_suggestion_very_good	Suggested price for Very Good (VG) condition
price_suggestion_good_plus	Suggested price for Good Plus (G+) condition
price_suggestion_good	Suggested price for Good (G) condition
price_suggestion_fair	Suggested price for Fair (F) condition
price_suggestion_poor	Suggested price for Poor (P) condition
community_have	Number of Discogs users who own this release
community_want	Number of Discogs users who want this release
community_rating_average	Average community rating (0-5)
community_rating_count	Total number of ratings
tracklist	Track listing (optional, enabled via includeTracklist)
identifiers	Barcodes, matrix numbers, and other identifiers
discogs_url	URL of the release on discogs.com

Price suggestion fields are only populated when a Discogs personal access token is provided (see Authentication below). Market stats (num_for_sale, lowest_price_value) are available without a token.

Input

Search by query

{
  "searchQuery": "Radiohead OK Computer",
  "maxItems": 50
}

The searchQuery field accepts any Discogs search syntax: artist name, album title, label name, or combinations. Searches are automatically scoped to vinyl (format=Vinyl).

Fetch specific release IDs

{
  "releaseIds": [249504, 1362375, 4950798],
  "maxItems": 10
}

Supply a list of known Discogs release IDs to fetch their marketplace data directly, bypassing the search step.

With tracklist

{
  "searchQuery": "Blue Note Records",
  "includeTracklist": true,
  "maxItems": 20
}

Enabling includeTracklist adds one additional API call per release.

Full input schema

Parameter	Type	Default	Description
searchQuery	string	—	Artist, album, or label search query
releaseIds	array	—	List of specific Discogs release IDs
discogsToken	string	—	Optional personal access token (see Authentication)
includeTracklist	boolean	false	Include full tracklist in each record
maxItems	integer	15	Maximum number of releases to return

Either searchQuery or releaseIds is required.

Authentication (optional but recommended)

Without a token:

• Rate limit: 60 requests/minute
• Price suggestions fields: not available (all null)

With a Discogs personal access token:

• Rate limit: 240 requests/minute (4x faster)
• Price suggestions: fully populated (all 8 condition levels)

To get a free personal access token:

1. Log in at discogs.com
2. Go to Settings then Developers
3. Click Generate new token
4. Paste the token into the discogsToken input field

Use cases

Vinyl resellers and record shops: Track current market prices and inventory depth for titles you buy and sell. Export to spreadsheet or connect to your pricing tool.

Collector price tracking: Run the actor on a schedule to build a lowest-price history for your want list. Identify the best time to buy.

Record store inventory pricing: Bulk-price your collection by condition using the per-condition price suggestions (Mint, NM, VG+, VG, G).

Market research: Analyze demand signals (community_have, community_want, community_rating_average) to identify undervalued or high-demand pressings.

Cross-source data joins: The release_id field links directly to Discogs. The identifiers field carries barcodes for joining with other datasets such as MusicBrainz.

Rate limits and speed

The Discogs API enforces global rate limits per IP address or token:

Mode	Approximate speed
Anonymous (no token)	~18-20 releases/minute
With personal access token	~60-70 releases/minute

For large jobs (hundreds of releases), supply a personal access token for significantly faster throughput.

Data freshness

Marketplace data (num_for_sale, lowest_price_value, price suggestions) reflects the Discogs marketplace at the time the actor runs. For price tracking, schedule recurring runs and store the results with a timestamp.

Technical notes

• Strategy: JSON API via Discogs public REST API at api.discogs.com
• No proxy required — the API is publicly accessible worldwide
• Memory: 256 MB
• Per-release API calls: 2 without token (release details + marketplace stats); 3 with token (adds price suggestions)
• The Discogs /sell/release/{id} HTML pages are not used — they return Cloudflare 403 errors