{
"openapi": "3.0.1",
"info": {
"title": "Discogs Scraper ยท Releases, Artists, Labels & Marketplace",
"description": "Discogs Scraper (Discogs.com scraper) to scrape vinyl records, CDs, music releases, artists, and labels. Extract marketplace prices, collector demand, formats, barcodes, and tracklists into CSV or JSON.",
"version": "1.0",
"x-build-id": "OPNdkVePQD3RJMG3a"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~discogs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-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/reapx~discogs-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-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/reapx~discogs-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-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": {
"query": {
"title": "Search query",
"type": "string",
"description": "Free text matched across artist, release title, label and catalogue number.
Leave this field empty to skip this filter."
},
"genre": {
"title": "Genre",
"type": "string",
"description": "A Discogs top-level genre - Electronic, Rock, Jazz, Hip Hop, Funk / Soul, Classical, Reggae, Pop, Folk, World, & Country, Latin, Blues, Non-Music, Stage & Screen, Brass & Military, Children's.
Leave this field empty to skip this filter."
},
"style": {
"title": "Style",
"type": "string",
"description": "A Discogs style, which is finer than a genre - Techno, House, Ambient, Drum n Bass, Hard Bop, Shoegaze, Bossa Nova.
Leave this field empty to skip this filter."
},
"label": {
"title": "Label name",
"type": "string",
"description": "Restrict to one record label by name, for example Warp Records, Blue Note, Motown.
Leave this field empty to skip this filter."
},
"country": {
"title": "Country",
"type": "string",
"description": "Country of release, for example UK, US, Germany, Japan.
Leave this field empty to skip this filter."
},
"format": {
"title": "Format",
"type": "string",
"description": "Physical or digital format - Vinyl, CD, Cassette, File, Box Set.
Leave this field empty to skip this filter."
},
"year": {
"title": "Year",
"type": "string",
"description": "A single release year, for example 1994.
Leave this field empty to skip this filter."
},
"artistIds": {
"title": "Discogs artist ids",
"type": "array",
"description": "Pull complete discographies instead of searching. One numeric Discogs artist id per line - the number in a discogs.com/artist/ URL.
Leave this field empty to include every option.",
"items": {
"type": "string"
}
},
"labelIds": {
"title": "Discogs label ids",
"type": "array",
"description": "One numeric Discogs label id per line - the number in a discogs.com/label/ URL. Returns that label's whole catalogue.
Leave this field empty to include every option.",
"items": {
"type": "string"
}
},
"minCommunityHave": {
"title": "Minimum collectors who own it",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Keep only releases at least this many Discogs users have in their collection - the simplest measure of how widely a pressing circulated."
},
"minForSale": {
"title": "Minimum copies for sale",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Keep only releases with at least this many copies currently listed in the Discogs marketplace."
},
"includeMarketData": {
"title": "Include marketplace and rating data",
"type": "boolean",
"description": "Read each release's full record for copies for sale, lowest price, star rating, tracklist and exact release date. Turn off for a faster, shallower run - the artist, label and catalogue number still come back."
},
"maxReleases": {
"title": "Maximum releases to return",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Hard ceiling on the rows this run produces, and therefore on what it costs. You are charged per release returned.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"requestsPerMinute": {
"title": "Requests per minute",
"minimum": 1,
"maximum": 25,
"type": "integer",
"description": "Discogs allows 25 requests a minute to an anonymous caller and this is capped there. Lower it if you see the API refusing requests."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}