# Discogs Scraper (`maximedupre/discogs`) Actor Search Discogs releases, artists, labels, and master releases. Get catalog details, community signals, cover links, and current marketplace prices without a Discogs login. - **URL**: https://apify.com/maximedupre/discogs.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** E-commerce, For creators, Developer tools - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.80 / 1,000 catalog entries This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ### 💿 Turn Discogs catalog pages into useful data Discogs Scraper is for record collectors, sellers, music researchers, and developers. Search public Discogs data or look up a known release. Get releases, artists, labels, master releases, catalog details, community signals, cover links, and current marketplace prices without a Discogs login. Use it to: - **[Discogs Scraper](https://apify.com/maximedupre/discogs/examples/discogs-scraper)** — collect public Discogs catalog rows for music research. - **[Discogs Vinyl Value](https://apify.com/maximedupre/discogs/examples/discogs-vinyl-value)** — check current availability, listing count, and lowest asking price for known releases. - **[Discogs Vinyl Record Price Guide](https://apify.com/maximedupre/discogs/examples/discogs-vinyl-record-price-guide)** — compare current marketplace price signals for a list of release IDs. - **[Discogs Release Search](https://apify.com/maximedupre/discogs/examples/discogs-release-search)** — find releases by artist, album, catalog number, or another keyword. - **[Discogs Marketplace Prices](https://apify.com/maximedupre/discogs/examples/discogs-marketplace-prices)** — export each release's current lowest asking price and currency when available. - **[Discogs Artist Search](https://apify.com/maximedupre/discogs/examples/discogs-artist-search)** — find artist profiles and their public Discogs links. - **[Discogs Label Search](https://apify.com/maximedupre/discogs/examples/discogs-label-search)** — find record labels and their public Discogs links. #### 📦 Data you get The Actor saves releases, artists, labels, and master releases. Fields depend on the row type. Release rows can include: - Discogs ID, title, URL, artists, date, year, and country - genres, styles, labels, catalog numbers, and formats - cover and thumbnail links - barcodes, matrix and runout values, and other identifiers - tracklists, durations, credits, companies, and media preview links - have and want counts, rating, status, and data quality - marketplace availability, listing count, lowest price, and currency Artist and label rows can include an ID, name, URL, thumbnail, and profile. Master release rows can include a title, artists, year, genres, styles, and image links. A field may be missing when Discogs does not provide it. When searches overlap, the first eligible match is saved. Later matches for the same Discogs resource are skipped. Rows already saved stay in the dataset if another input is invalid or fails. #### 🚀 Run the Actor 1. Choose a **Target**. 2. Add one or more search values, release URLs, or release IDs for that target. 3. Set a result limit. Release searches can also use the shown filters. 4. Run the Actor and open the dataset. No Discogs API key or account login is needed for this public data. #### 🛠️ Input Use `target` to choose one job: - `releaseSearch` searches releases with `releaseSearchValues`. Optional `releaseSearchOptions` can narrow results by year, country, genre, style, format, or label and set `maxResults`. - `releaseDetails` gets full rows for `releaseValues`, which can hold Discogs release URLs or numeric IDs. - `artistSearch` searches `artistSearchValues` and uses `artistMaxResults`. - `labelSearch` searches `labelSearchValues` and uses `labelMaxResults`. - `masterSearch` searches `masterSearchValues` and uses `masterMaxResults`. Options for a different target are ignored. Here is a valid release-details input: ```json { "target": "releaseDetails", "releaseValues": [ "https://www.discogs.com/release/249504-Miles-Davis-Kind-Of-Blue", "249504" ] } ```` #### 📄 Output Each saved dataset row has a `rowType` of `release`, `artist`, `label`, or `master`. A release row may look like this: ```json { "rowType": "release", "id": 249504, "title": "Kind Of Blue", "url": "https://www.discogs.com/release/249504-Miles-Davis-Kind-Of-Blue", "artists": [ { "name": "Miles Davis" } ], "year": 1959, "country": "US", "genres": ["Jazz"], "marketplace": { "available": true, "listingCount": 42, "lowestPrice": 24.99, "currency": "USD" } } ``` Values above are an example. Live Discogs data can differ. Open the dataset to export saved rows or read them through the Apify API. #### 💳 Pricing This Actor uses pay-per-event pricing. You are charged for each release, master release, artist, or label saved to the dataset. Inputs that do not create a catalog row are not described as charged outcomes. Check the Actor pricing tab for the current rate. #### 🔌 Integrations Use Apify schedules to run searches again. Send dataset rows to webhooks or connect them to other Apify integrations. You can also read the dataset with the Apify API. https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 #### ❓ FAQ ##### Can I get sold-price history? No. The Actor returns current marketplace availability, listing count, lowest asking price, and currency. It does not rebuild sold-listing or long-term price history. ##### Can I use private collections or wantlists? No. It reads public catalog and marketplace data. It does not open or change private account data. ##### What happens when two searches find the same release? The first eligible match is saved. A later match for that release is skipped, so one run does not save the same Discogs resource twice. ##### Can one run search different resource types? Choose one target for each run. You can give that target several values, but you cannot set up separate artist, label, master, and release jobs in the same run. ##### Does a low marketplace price show a record's true value? No. It is the current lowest asking price shown by Discogs when available. It is not a sale price, appraisal, grading result, or promise of value. ##### Does the Actor download covers, audio, or video? No. It can return public image and media preview links when available, but it does not download or mirror those files. ### 📝 Changelog - 0.1: Initial release. ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~discogs/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Related Actors - [SoundCloud Scraper](https://apify.com/maximedupre/soundcloud-scraper) — research public tracks, artists, playlists, albums, and comments on SoundCloud. - [YouTube Music Scraper](https://apify.com/maximedupre/youtube-music-scraper) — search songs, albums, artists, playlists, podcasts, and profiles on YouTube Music. - [Musescore Scraper](https://apify.com/maximedupre/musescore-scraper) — find public sheet music and score details for related catalog research. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `target` (type: `string`): Choose the Discogs source or row type to collect. Options for other Targets are ignored. ## `releaseSearchValues` (type: `array`): Enter one or more keywords to search for releases. Each value runs as part of this search. ## `releaseSearchOptions` (type: `object`): Narrow release results. Leave fields empty to include all matching values. ## `releaseValues` (type: `array`): Enter one or more Discogs release URLs or numeric release IDs. ## `artistSearchValues` (type: `array`): Enter one or more artist names or keywords. ## `artistMaxResults` (type: `integer`): Stop after this many matching artists across all search values. ## `labelSearchValues` (type: `array`): Enter one or more label names or keywords. ## `labelMaxResults` (type: `integer`): Stop after this many matching labels across all search values. ## `masterSearchValues` (type: `array`): Enter one or more master release titles or keywords. ## `masterMaxResults` (type: `integer`): Stop after this many matching master releases across all search values. ## Actor input object example ```json { "target": "releaseSearch", "releaseSearchValues": [ "Miles Davis" ], "releaseSearchOptions": { "yearFrom": 1959, "yearTo": 1959, "country": "US", "genre": "Jazz", "format": "Vinyl", "maxResults": 3 }, "artistMaxResults": 100, "labelMaxResults": 100, "masterMaxResults": 100 } ``` # Actor output Schema ## `dataset` (type: `string`): Open the saved Discogs catalog results. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "target": "releaseSearch", "releaseSearchValues": [ "Miles Davis" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/discogs").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "target": "releaseSearch", "releaseSearchValues": ["Miles Davis"], } # Run the Actor and wait for it to finish run = client.actor("maximedupre/discogs").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 '{ "target": "releaseSearch", "releaseSearchValues": [ "Miles Davis" ] }' | apify call maximedupre/discogs --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/discogs", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Discogs Scraper", "description": "Search Discogs releases, artists, labels, and master releases. Get catalog details, community signals, cover links, and current marketplace prices without a Discogs login.", "version": "0.1", "x-build-id": "xnrbvpFLpS3ScEe5Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~discogs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-discogs", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/maximedupre~discogs/runs": { "post": { "operationId": "runs-sync-maximedupre-discogs", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/maximedupre~discogs/run-sync": { "post": { "operationId": "run-sync-maximedupre-discogs", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "target" ], "properties": { "target": { "title": "Target", "enum": [ "releaseSearch", "releaseDetails", "artistSearch", "labelSearch", "masterSearch" ], "type": "string", "description": "Choose the Discogs source or row type to collect. Options for other Targets are ignored.", "default": "releaseSearch" }, "releaseSearchValues": { "title": "Search values", "minItems": 1, "type": "array", "description": "Enter one or more keywords to search for releases. Each value runs as part of this search.", "items": { "type": "string", "minLength": 1 }, "default": [ "Miles Davis" ] }, "releaseSearchOptions": { "title": "Search filters", "type": "object", "description": "Narrow release results. Leave fields empty to include all matching values.", "properties": { "yearFrom": { "type": "integer", "title": "Year from", "description": "Include releases from this year onward.", "minimum": 1, "maximum": 9999, "prefill": 1959 }, "yearTo": { "type": "integer", "title": "Year to", "description": "Include releases up to this year.", "minimum": 1, "maximum": 9999, "prefill": 1959 }, "country": { "type": "string", "title": "Country", "description": "Match a release country.", "minLength": 1, "prefill": "US" }, "genre": { "type": "string", "title": "Genre", "description": "Match a music genre.", "minLength": 1, "prefill": "Jazz" }, "style": { "type": "string", "title": "Style", "description": "Match a music style.", "minLength": 1 }, "format": { "type": "string", "title": "Format", "description": "Match a release format, such as Vinyl or CD.", "minLength": 1, "prefill": "Vinyl" }, "label": { "type": "string", "title": "Label", "description": "Match a record label.", "minLength": 1 }, "maxResults": { "type": "integer", "title": "Maximum results", "description": "Stop after this many matching releases across all search values.", "minimum": 1, "maximum": 1000, "default": 3 } }, "default": { "yearFrom": 1959, "yearTo": 1959, "country": "US", "genre": "Jazz", "format": "Vinyl", "maxResults": 3 } }, "releaseValues": { "title": "Release URLs or IDs", "minItems": 1, "type": "array", "description": "Enter one or more Discogs release URLs or numeric release IDs.", "items": { "type": "string", "minLength": 1 } }, "artistSearchValues": { "title": "Search values", "minItems": 1, "type": "array", "description": "Enter one or more artist names or keywords.", "items": { "type": "string", "minLength": 1 } }, "artistMaxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many matching artists across all search values.", "default": 100 }, "labelSearchValues": { "title": "Search values", "minItems": 1, "type": "array", "description": "Enter one or more label names or keywords.", "items": { "type": "string", "minLength": 1 } }, "labelMaxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many matching labels across all search values.", "default": 100 }, "masterSearchValues": { "title": "Search values", "minItems": 1, "type": "array", "description": "Enter one or more master release titles or keywords.", "items": { "type": "string", "minLength": 1 } }, "masterMaxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many matching master releases across all search values.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```