{ "openapi": "3.0.1", "info": { "title": "Discogs Scraper", "description": "[💰 $3 / 1K] Extract releases, masters, artists, and labels from Discogs — catalog numbers, formats, barcodes, matrix/runout, tracklists, credits, plus marketplace price and have/want stats. Search by keyword or paste Discogs URLs; filter by genre, style, format, country, year, and label.", "version": "1.0", "x-build-id": "gf2qiNO1BeIbLmY5N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~discogs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-discogs-scraper", "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/solidcode~discogs-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-discogs-scraper", "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/solidcode~discogs-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-discogs-scraper", "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", "properties": { "searchQueries": { "title": "Search Terms", "type": "array", "description": "What to look for on Discogs — an artist, an album, a label, or a catalog number. Add as many terms as you like; each one is searched separately. You can also leave this empty and use the filters below on their own to browse a whole genre or year.", "items": { "type": "string" } }, "startUrls": { "title": "Discogs URLs", "type": "array", "description": "Already have a page in mind? Paste Discogs release, master, artist, or label URLs here to scrape them directly, no search needed. Each URL always comes back with its full details, and the URL's own kind of record wins over the 'What to Return' setting below.", "items": { "type": "string" } }, "resultType": { "title": "What to Return", "enum": [ "release", "master", "artist", "label" ], "type": "string", "description": "Choose the kind of record you want back from your search terms. 'Release' is a specific pressing (a particular vinyl or CD edition); 'Master' groups every pressing of the same album together. Artists and labels come back as profile records — turn on 'Include Full Details' to get anything beyond their name and picture." }, "maxItems": { "title": "Maximum Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many records to collect per run. Higher numbers take longer and cost more. Results arrive in pages, so a run asking for a number that isn't a round page size may return a few extra records rather than cutting a page short." }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Adds the full tracklist, production credits, barcode and matrix/runout numbers, linked videos, and release notes to every record. Strongly recommended for artists and labels — without it those come back as little more than a name. Turn it off for a faster, lighter run. On very large runs a small number of records may arrive without these extra fields." }, "genre": { "title": "Genre", "enum": [ "Blues", "Brass & Military", "Children's", "Classical", "Electronic", "Folk, World, & Country", "Funk / Soul", "Hip Hop", "Jazz", "Latin", "Non-Music", "Pop", "Reggae", "Rock", "Stage & Screen" ], "type": "string", "description": "Narrow results to one broad genre. Leave empty to include every genre." }, "style": { "title": "Style", "type": "string", "description": "A more precise sub-genre than the genre filter — for example 'House', 'Techno', 'Shoegaze', 'Bebop', or 'Death Metal'. Must match a real Discogs style name exactly; a typo or an invented style returns no results." }, "format": { "title": "Format", "enum": [ "Vinyl", "CD", "Cassette", "File", "CDr", "DVD", "Box Set", "Shellac", "8-Track Cartridge", "All Media", "VHS", "Reel-To-Reel", "Blu-ray", "Acetate", "SACD", "Laserdisc", "Hybrid", "Flexi-disc", "Lathe Cut", "Minidisc", "Memory Stick", "Floppy Disk" ], "type": "string", "description": "Limit results to one physical or digital format." }, "country": { "title": "Country", "enum": [ "US", "UK", "Europe", "Japan", "Germany", "Canada", "Australia", "France", "Italy", "Netherlands", "Russia", "Spain", "Brazil", "Poland", "South Africa", "Sweden", "New Zealand", "UK & Europe", "Belgium", "Worldwide", "Greece", "Mexico", "Argentina", "Switzerland", "Finland", "Denmark", "South Korea", "Portugal", "Ireland", "Austria", "Norway", "Israel", "Yugoslavia", "Czech Republic", "Turkey", "India", "Hungary", "USSR", "German Democratic Republic (GDR)", "Unknown" ], "type": "string", "description": "The country a record was released in. Pick from the list — Discogs uses its own country names, so typing something like 'United Kingdom' instead of 'UK' would return nothing." }, "label": { "title": "Record Label", "type": "string", "description": "Only return records put out by this label — for example 'Motown', 'Blue Note', or 'Virgin'. Must match a real Discogs label name; a misspelling returns no results." }, "year": { "title": "Release Year", "type": "string", "description": "A single year (e.g. 1998) or a range (e.g. 2010-2015). Leave empty to include every year." }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "yearDesc", "yearAsc", "titleAsc", "titleDesc", "haveDesc", "wantDesc" ], "type": "string", "description": "Choose the order results come back in. Leave empty for Discogs' own relevance ranking." } } }, "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 } } } } } } } } } }