Discogs Scraper - Vinyl Records & Music Database

Search and extract music release data from the Discogs database -- the largest online music catalog with 8M+ releases.

What it does

This scraper queries the Discogs public API to extract structured data about vinyl records, CDs, cassettes, and other music formats. It returns detailed information including artist, title, year, country, format, genre, style, community ratings, want/have counts, and optionally full tracklists and marketplace pricing.

Features

• Search 8M+ releases by artist, album, genre, style, country, year, or format
• Multiple search types: releases, master releases, artists, labels
• Community data: ratings, want counts, have counts
• Full details mode: tracklists, marketplace prices (lowest price, number for sale), images, videos
• Smart rate limiting: respects Discogs 25 req/min limit with automatic backoff on 429 responses
• Pagination: automatically fetches multiple pages up to your maxResults limit

Input

Field	Type	Default	Description
searchQuery	string	(required)	Artist or album name
type	select	release	release, master, artist, or label
genre	string		Filter by genre (Rock, Jazz, Electronic, etc.)
style	string		Filter by style (Punk, Ambient, Bebop, etc.)
country	string		Country of release (US, UK, Japan, etc.)
year	string		Year or range (1975 or 1970-1980)
format	string		Format filter (Vinyl, CD, Cassette, etc.)
fetchDetails	boolean	false	Fetch full tracklist, prices, images per release
maxResults	integer	100	Max results (1-5000)

Output

Each result includes:

{
    "id": 4786721,
    "type": "release",
    "title": "Abbey Road",
    "artist": "The Beatles",
    "year": "1969",
    "country": "UK",
    "format": ["Vinyl", "LP", "Album", "Stereo"],
    "genre": ["Rock"],
    "style": ["Pop Rock"],
    "label": ["Apple Records"],
    "rating": 4.57,
    "ratingCount": 8234,
    "wantCount": 12456,
    "haveCount": 98765,
    "thumbnail": "https://...",
    "coverImage": "https://...",
    "uri": "https://www.discogs.com/...",
    "scrapedAt": "2026-04-25T12:00:00.000Z"
}

With fetchDetails: true, each release also includes:

{
    "tracklist": [
        { "position": "A1", "title": "Come Together", "duration": "4:19" },
        { "position": "A2", "title": "Something", "duration": "3:02" }
    ],
    "numForSale": 1234,
    "lowestPrice": 15.99,
    "artists": [{ "name": "The Beatles", "id": 82730 }],
    "labels": [{ "name": "Apple Records", "catno": "PCS 7088" }],
    "images": [{ "type": "primary", "uri": "https://..." }],
    "videos": [{ "title": "Come Together", "url": "https://..." }]
}

Rate limits

The Discogs API allows 25 unauthenticated requests per minute. This scraper automatically:

• Adds 2.5s delays between all API calls
• Retries with exponential backoff on 429 (rate limit) responses
• Search-only mode (~20 results/minute): 100 results in ~15 seconds
• Details mode (~24 releases/minute): 100 releases in ~4-5 minutes

Use cases

• Vinyl collectors: Find pressings, compare prices across releases
• Record stores: Monitor marketplace pricing and availability
• Music researchers: Analyze discographies, genre trends, release patterns
• Price tracking: Track lowest marketplace prices for specific releases
• Data analysis: Genre/style distribution, country of origin analysis

Tips

• Start without fetchDetails to quickly browse results, then enable it for releases you care about
• Use genre + style together for precise filtering (e.g., genre="Electronic", style="Ambient")
• Year ranges work well for decade analysis (e.g., year="1980-1989")
• The master type groups all pressings of an album into one result