# Discogs Music Releases & Artists Scraper (`scrapers_lat/discogs-scraper`) Actor

Extract Discogs music releases and artists: tracklist, labels, catalog number, format, genres, ratings, community have/want and lowest marketplace price. Export JSON, CSV, Excel.

- **URL**: https://apify.com/scrapers\_lat/discogs-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.80 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![Discogs Music Releases & Artists Scraper](https://scrapers.lat/banners/discogs-scraper.png)](https://console.apify.com/actors/C8ZT7r30uRhhbziIJ/input)

## Discogs Scraper

> Extract music releases and artists from Discogs, with tracklists, catalog numbers, ratings, community have/want counts and lowest marketplace prices across the full global database

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-Global-blue)
![Maintained](https://img.shields.io/badge/Maintained-Yes-brightgreen)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)

<table><tr>
<td align="center"><strong>30+ fields</strong><br>per record</td>
<td align="center"><strong>Global</strong><br>coverage</td>
<td align="center"><strong>JSON / CSV / Excel</strong><br>output formats</td>
<td align="center"><strong>Updated</strong><br>2026-07-26</td>
</tr></table>

<br>

### What you get

Each record is a music release or an artist from Discogs, with everything you need to build a catalog, price a collection, or enrich a music dataset. Search by keyword or paste release, master, artist and label URLs.

- **imageUrl\***: cover art or artist photo
- **title**: release title with artist, or artist name
- **type**: release, master, artist or label
- **url**: link to the Discogs page
- **id**: Discogs numeric identifier
- **artist**: artist name (or joined list for collaborations)
- **artistNames\***: every credited artist as a list
- **label**: record label name (or joined list)
- **labelNames**: each label as a list
- **catalogNumber**: primary catalog number
- **catalogNumbers**: every catalog number on the release
- **format**: media format and descriptions (Vinyl LP Album, CD, etc.)
- **formatDescriptions**: format tags as a list
- **country**: country of release
- **released**: release year or date
- **genre**: primary genres
- **genres**: genre list
- **style**: musical styles
- **styles**: style list
- **masterId**: id of the parent master release
- **communityHave**: how many collectors own it
- **communityWant**: how many collectors want it
- **ratingAverage\***: average community rating out of 5
- **ratingCount\***: number of ratings
- **lowestPrice\***: lowest current marketplace price
- **priceCurrency\***: currency of the lowest price
- **numForSale\***: number of copies for sale
- **trackCount\***: number of tracks
- **tracklist\***: each track with position, title and duration
- **profile\***: artist or label profile text
- **aliases\***: artist aliases
- **members\***: band members
- **artistUrls\***: official and social links for the artist or label
- **searchInput**: the query or URL that produced this record
- **observedAt**: when this record was last seen by the scraper

*\*These fields only appear when Fetch Full Details is set to true.*

### Who is it for

| Use case | Who benefits |
|---|---|
| Value a vinyl or CD collection against live market prices | Collectors and record dealers |
| Build a music metadata catalog with genres, styles and tracklists | Music apps and data teams |
| Track demand with have and want counts per pressing | Sellers and flippers |
| Enrich a discography with artist profiles, members and aliases | Journalists and researchers |
| Monitor lowest marketplace prices across pressings | Vinyl marketplace analysts |

### Frequently Asked Questions

**Does this cover the whole Discogs database or just one region?**
It covers the full global Discogs catalog. Releases, master releases, artists and labels from every country in the database are searchable, and prices are reported in their native marketplace currency.

**How many records can I get in one run?**
Set the Max Releases value to whatever you need. One run can search several queries and process many direct URLs at once, and results stream into the dataset as they are collected.

**Can I scrape specific releases or artists by URL instead of searching?**
Yes. Paste release, master, artist or label URLs into the Discogs URLs field and the scraper pulls each one directly. You can mix search queries and URLs in the same run.

**Where do the marketplace prices and ratings come from?**
When Fetch Full Details is enabled, each release is enriched with its live lowest marketplace price, the number of copies for sale, and the community rating. Turn it off for a faster, listing only run.

**What happens if a release has no price or is not for sale?**
Price and for sale fields are simply left empty for that record, and the rest of the data is still returned. Records that cannot be fetched are reported with an error field so the run never fails silently.

### Related scrapers

Need data from the same space? Here are other scrapers we build and maintain:

- [eBay Product Listings & Price Scraper](https://apify.com/scrapers_lat/ebay-scraper): marketplace listings and prices for vinyl, CDs and collectibles
- [Amazon Product Price & Reviews Scraper](https://apify.com/scrapers_lat/amazon-product-scraper): product data, prices and reviews from Amazon
- [Ticketmaster Events, Venues & Prices Scraper](https://apify.com/scrapers_lat/ticketmaster-scraper): concerts, tours and ticket prices
- [SeatGeek Event Tickets & Prices Scraper](https://apify.com/scrapers_lat/seatgeek-events-scraper): live music events and ticket pricing
- [Apple App Store Reviews & Ratings Scraper](https://apify.com/scrapers_lat/app-store-reviews-scraper): app reviews and ratings for media apps
- [Chrome Web Store Extensions Scraper](https://apify.com/scrapers_lat/chrome-web-store-scraper): extension listings, ratings and install counts

### More scrapers at scrapers.lat

This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> This actor is an independent tool and has no affiliation with Discogs. It only accesses data that is publicly available on the platform. Use it in accordance with Discogs's terms of service.

# Actor input Schema

## `maxReleases` (type: `integer`):

Maximum number of records to collect across all searches and URLs. Optional.

## `withDetails` (type: `boolean`):

When enabled, each release is enriched with tracklist, cover image, community rating and lowest marketplace price. Artists get profile, aliases and members.

## `searchQueries` (type: `array`):

Artist, release or label names to search on Discogs. Each query is searched separately. Accepts a single string too.

## `searchType` (type: `string`):

Which kind of entity to return for search queries.

## `startUrls` (type: `array`):

Direct Discogs URLs to scrape (release, master, artist or label pages, e.g. https://www.discogs.com/release/249504).

## Actor input object example

```json
{
  "maxReleases": 10,
  "withDetails": true,
  "searchQueries": [
    "Daft Punk Discovery"
  ],
  "searchType": "release"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxReleases": 10,
    "searchQueries": [
        "Daft Punk Discovery"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/discogs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxReleases": 10,
    "searchQueries": ["Daft Punk Discovery"],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/discogs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxReleases": 10,
  "searchQueries": [
    "Daft Punk Discovery"
  ]
}' |
apify call scrapers_lat/discogs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapers_lat/discogs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/C8ZT7r30uRhhbziIJ/builds/F2JK38VbbRMsU5D0f/openapi.json
