Discogs.com Scraper

What does Discogs.com Scraper do?

Discogs.com Scraper collects structured release records from Discogs for collectors, record dealers, catalog researchers, and music-market analysts. Run it with a Discogs release, master, or sell-list URL, a filtered Discogs search URL, or a keyword. The dataset can include release metadata, marketplace availability, pricing, community collection and wantlist counts, and direct Discogs links.

Use the results to build release catalogs, compare supply and demand, research vinyl opportunities, monitor prices, or feed music data into spreadsheets and automation workflows.

Why use Discogs.com Scraper?

• Several discovery modes - Start from one release, all versions of a master, a keyword, or URL search filters.
• Release catalog data - Collect titles, artists, labels, catalog numbers, formats, genres, styles, countries, years, and release dates.
• Marketplace signals - Optionally collect active listing counts, lowest listed prices, currencies, and sale availability.
• Community demand signals - Use collection and wantlist counts, plus rating information when detailed release data is enabled.
• Controlled runs - Set the maximum records and page depth for small tests or larger datasets.
• Automation-ready output - Export the Apify dataset as JSON, CSV, Excel, XML, or another supported format, or connect it to an API, webhook, Google Sheets, Make, or Zapier.

What data can you extract from Discogs?

The fields available depend on the input mode and optional enrichment settings. Empty fields are removed before records are saved.

Field	Type	Description
query_mode	String	Resolved mode: keyword, master, release, or url_search
source_url	String	Input URL when a URL was supplied
keyword	String	Keyword used for discovery
release_id	Integer	Discogs release identifier
master_id	Integer	Discogs master identifier when available
title	String	Release title
artists	Array	Artist names when detailed release data is available
artists_sort	String	Discogs artist sort label
year	Integer	Release year
released	String	Discogs release date value
released_formatted	String	Human-readable release date
country	String	Release country
genres	Array	Genre tags
styles	Array	Style tags
labels	Array	Label names
catno	String	Catalog number
formats	Array	Format names and descriptions
format_quantity	Integer	Number of media units
num_for_sale	Integer	Current listing count when available
lowest_price_value	Number	Lowest listed price when available
lowest_price_currency	String	Currency for the lowest listed price
blocked_from_sale	Boolean	Whether the release is blocked from sale
community_have	Integer	Number of users who have the release
community_want	Integer	Number of users who want the release
community_rating_average	Number	Community rating average
community_rating_count	Integer	Number of community ratings
data_quality	String	Discogs data-quality label when available
status	String	Discogs release status when available
discogs_url	String	Public Discogs release URL
release_api_url	String	Canonical release data URL
thumb	String	Thumbnail image URL
cover_image	String	Cover image URL
date_added	String	Date the release record was added
date_changed	String	Date the release record was last changed
fetched_at	String	ISO timestamp for the extraction

How to use Discogs.com Scraper

1. Open the Actor in Apify Console.
2. Provide a supported Discogs URL or a keyword.
3. Set results_wanted and max_pages.
4. Enable release details or marketplace statistics if those fields are needed.
5. Run the Actor and inspect the dataset preview.
6. Download the results or connect the dataset to your workflow.

At least one of url or keyword must contain usable input. If both are supplied, a recognized URL takes precedence, except that a keyword can be used with a generic /sell/list URL that has no filters.

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	-	Discogs URL. Supports release pages, master pages, /sell/release/{id}, and /sell/list URLs with IDs or search filters.
keyword	String	No	-	Search term used when no recognized URL mode is available.
results_wanted	Integer	No	20	Maximum number of unique release records to save. Minimum: 1.
max_pages	Integer	No	10	Maximum number of result pages to scan. Minimum: 1.
fetch_release_details	Boolean	No	false	Fetch fuller release metadata for each result. Release URL runs fetch details automatically.
fetch_marketplace_stats	Boolean	No	false	Fetch listing count, lowest price, currency, and sale availability for each release.

URL search filters

Generic https://www.discogs.com/sell/list URLs can pass supported search parameters. The recognized filters are q, artist, label, genre, style, country, year, format, catno, barcode, track, title, release_title, credit, and anv.

For example, this URL searches for electronic releases by a specific artist and year:

https://www.discogs.com/sell/list?artist=Depeche+Mode&genre=Electronic&year=1987

Usage Examples

Collect versions from a master

Use a master URL to collect individual release versions, including different countries, years, labels, and formats.

{
    "url": "https://www.discogs.com/master/1182241",
    "results_wanted": 50,
    "max_pages": 5
}

Search releases by keyword

Use a keyword for broad release discovery.

{
    "keyword": "Nirvana",
    "results_wanted": 30,
    "max_pages": 5
}

Search with URL filters

Pass supported Discogs search filters in a /sell/list URL to narrow the records returned.

{
    "url": "https://www.discogs.com/sell/list?artist=Depeche+Mode&genre=Electronic&year=1987",
    "results_wanted": 25,
    "max_pages": 3
}

Collect a release with enrichment

Release URLs automatically request detailed release data. Enable marketplace statistics when you also need current supply and floor-price signals.

{
    "url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
    "fetch_marketplace_stats": true
}

Enable both enrichments for a keyword search

Use these flags for smaller research runs where complete metadata and marketplace signals matter more than throughput.

{
    "keyword": "Depeche Mode",
    "results_wanted": 20,
    "max_pages": 2,
    "fetch_release_details": true,
    "fetch_marketplace_stats": true
}

Sample Output

This example shows a release run with marketplace statistics available. Fields can be omitted when the source does not provide them or when optional enrichment is disabled.

{
    "query_mode": "release",
    "source_url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
    "release_id": 249504,
    "master_id": 96559,
    "title": "Never Gonna Give You Up",
    "artists": ["Rick Astley"],
    "artists_sort": "Rick Astley",
    "year": 1987,
    "released": "1987",
    "country": "UK",
    "genres": ["Electronic", "Pop"],
    "styles": ["Synth-pop"],
    "labels": ["RCA"],
    "catno": "RCA 5010",
    "formats": ["Vinyl - 7\""],
    "format_quantity": 1,
    "num_for_sale": 104,
    "lowest_price_value": 0.68,
    "lowest_price_currency": "USD",
    "blocked_from_sale": false,
    "community_have": 4008,
    "community_want": 575,
    "community_rating_average": 3.82,
    "community_rating_count": 228,
    "discogs_url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
    "release_api_url": "https://api.discogs.com/releases/249504",
    "fetched_at": "2026-08-12T00:00:00.000Z"
}

Tips for Best Results

• Start small - Test with 10 to 20 records before increasing the limit.
• Use the narrowest input - A release URL is precise, a master URL finds versions, and a keyword is best for discovery.
• Use URL filters for targeted research - Combine artist, label, genre, style, country, year, format, or catalog filters where appropriate.
• Reserve enrichment for focused runs - Detailed release and marketplace requests add useful fields but can reduce throughput.
• Watch high-volume runs - For search-like runs with more than 100 results or more than 5 pages, enrichment is automatically disabled to keep the run stable.
• Expect source-dependent fields - Some releases do not publish ratings, images, marketplace counts, or complete metadata.
• Use schedules for monitoring - Repeat a consistent query daily or weekly and compare listing counts and lowest prices over time.

Integrations and Export Formats

• Dataset exports - Download JSON, CSV, Excel, XML, and other formats supported by Apify.
• API access - Retrieve completed dataset items from your own application.
• Google Sheets - Create sortable release watchlists and research tables.
• Webhooks - Notify another service when a run finishes.
• Make or Zapier - Send release records to downstream automation steps.

Frequently Asked Questions

Can I run the Actor with only a keyword?

Yes. Provide keyword without a URL to search for Discogs releases.

Which Discogs URLs are supported?

Release pages, master pages, /sell/release/{id} pages, sell-list URLs containing release_id or master_id, and generic /sell/list URLs with supported search filters are supported.

What happens when both url and keyword are provided?

A recognized URL is used first. If the URL is a generic, unfiltered /sell/list URL, the explicit keyword is used instead.

Are marketplace prices collected by default?

Not always. Enable fetch_marketplace_stats when current listing counts and lowest prices are required. Some release summaries may include partial marketplace values even when the flag is off.

Are full release details collected by default?

Release URL runs fetch full release details automatically. For keyword, master, and filtered URL searches, set fetch_release_details to true when you need fuller metadata.

Why are some output fields missing?

Fields are omitted when Discogs does not provide a value or when the relevant optional enrichment was not requested. The Actor also removes empty and null values from saved records.

Can I schedule recurring price checks?

Yes. Create an Apify schedule with the same input and compare successive datasets for changes in supply and lowest listed price.

Can I export the results to CSV or Excel?

Yes. Apify datasets support CSV, Excel, JSON, XML, and other export formats.

Is collecting Discogs data legal?

You are responsible for following Discogs terms, applicable laws, privacy requirements, and any restrictions that apply to your intended use. Collect only data you are authorized to use and avoid treating marketplace values as guaranteed sale prices.

Related Actors

Other Actors from the Shahid Irfan Apify profile:

• Apify Store Scraper - Collect Apify Store actor listings, descriptions, pricing, reviews, and usage data.
• Expedia Hotels Scraper - Extract hotel prices, ratings, availability, amenities, and property links from Expedia.
• Sephora Scraper - Collect Sephora product and catalog data for ecommerce research.

Support

For issues, feature requests, or missing fields, use the Issues tab on the Apify Actor page. Include the input used, the run ID, and an example of the output that needs attention.

Legal Notice

This Actor is intended for legitimate collection and analysis of publicly available Discogs data. Users are responsible for complying with Discogs terms, Apify policies, applicable laws, and the rules governing their use of marketplace and community information.