{ "openapi": "3.0.1", "info": { "title": "Discogs Scraper — Vinyl, Music Releases, Artists & Labels", "description": "Unofficial Discogs API — no key, no browser. Scrape music releases, vinyl records, masters, artists & labels: full discographies, label catalogs, every pressing/version, genres, styles, formats, catalog numbers and marketplace stats. Export Discogs data to JSON, CSV or Excel.", "version": "1.0", "x-build-id": "2CkmJboFq9uSS5bd5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~discogs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-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/logiover~discogs-scraper/runs": { "post": { "operationId": "runs-sync-logiover-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/logiover~discogs-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "artistReleases", "labelReleases", "masterVersions", "search", "release", "master", "artist", "label" ], "type": "string", "description": "Which Discogs endpoint to run.\n\n• **artistReleases** — an artist's full discography, paginated (highest volume)\n• **labelReleases** — a record label's full catalog, paginated (high volume)\n• **masterVersions** — every pressing/version of an album, paginated (high volume)\n• **search** — free-text search across releases, masters, artists and labels\n• **release** — full details for one or more release IDs (batch)\n• **master** — full details for one or more master (album) IDs (batch)\n• **artist** — profile details for one or more artist IDs (batch)\n• **label** — details for one or more label IDs (batch)", "default": "artistReleases" }, "artistId": { "title": "Artist ID", "type": "string", "description": "Discogs artist ID for **artistReleases** and **artist** modes, e.g. `108713`. The number in a `discogs.com/artist/108713-…` URL." }, "artistIds": { "title": "Artist IDs (batch, artist mode)", "type": "array", "description": "Array of Discogs artist IDs for batch **artist** detail lookups.", "items": { "type": "string" }, "default": [] }, "labelId": { "title": "Label ID", "type": "string", "description": "Discogs label ID for **labelReleases** and **label** modes, e.g. `1` (Planet E). The number in a `discogs.com/label/1-…` URL." }, "labelIds": { "title": "Label IDs (batch, label mode)", "type": "array", "description": "Array of Discogs label IDs for batch **label** detail lookups.", "items": { "type": "string" }, "default": [] }, "masterId": { "title": "Master ID", "type": "string", "description": "Discogs master (album) ID for **masterVersions** and **master** modes, e.g. `13814` (Nirvana — Nevermind). The number in a `discogs.com/master/13814-…` URL." }, "masterIds": { "title": "Master IDs (batch, master mode)", "type": "array", "description": "Array of Discogs master IDs for batch **master** detail lookups.", "items": { "type": "string" }, "default": [] }, "releaseId": { "title": "Release ID", "type": "string", "description": "Discogs release ID for **release** mode, e.g. `1018`. The number in a `discogs.com/release/1018-…` URL." }, "releaseIds": { "title": "Release IDs (batch)", "type": "array", "description": "Array of Discogs release IDs for batch **release** detail lookups.", "items": { "type": "string" }, "default": [] }, "query": { "title": "Search query", "type": "string", "description": "Free-text term for **search** mode (artist name, album, label, catalog number, barcode, etc.)." }, "searchType": { "title": "Search entity type", "enum": [ "release", "master", "artist", "label" ], "type": "string", "description": "Restrict **search** results to one entity type. Leave empty to search everything." }, "sort": { "title": "Sort (artistReleases)", "enum": [ "year", "title", "format" ], "type": "string", "description": "Optional sort field for **artistReleases**. One of `year`, `title`, `format`. Leave empty for Discogs default order." }, "sortOrder": { "title": "Sort order", "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction for the artistReleases `sort` field.", "default": "desc" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper bound on rows returned. For the list modes (artistReleases / labelReleases / masterVersions / search) this drives pagination; for batch detail modes it is effectively the number of IDs you pass.", "default": 200 } } }, "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 } } } } } } } } } }