{ "openapi": "3.0.1", "info": { "title": "Bandcamp Scraper", "description": "Scrape Bandcamp albums, tracks, artists and labels, Bandcamp search and Discover: prices, formats, release dates, labels, tracklists, ISRC, lyrics and discographies.", "version": "1.1", "x-build-id": "5ODSi3dv421P604Jz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/service-paradis~bandcamp-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-service-paradis-bandcamp-crawler", "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/service-paradis~bandcamp-crawler/runs": { "post": { "operationId": "runs-sync-service-paradis-bandcamp-crawler", "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/service-paradis~bandcamp-crawler/run-sync": { "post": { "operationId": "run-sync-service-paradis-bandcamp-crawler", "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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Album, track, artist or label pages, on bandcamp.com or on an artist's own domain. An artist URL (for example https://artist.bandcamp.com) gives the artist and, by default, their whole discography.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Bandcamp, one search per line. Bandcamp returns up to 50 results per search.", "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "all", "albums", "tracks", "artists" ], "type": "string", "description": "Which kind of results the searches return.", "default": "all" }, "discoverGenres": { "title": "Discover genres", "type": "array", "description": "Genres or tags to browse on Bandcamp Discover, for example metal, hip-hop-rap, ambient or jazz. One genre per line.", "items": { "type": "string" } }, "discoverSort": { "title": "Discover sort", "enum": [ "top", "new", "rand" ], "type": "string", "description": "Order of the Discover results.", "default": "top" }, "discoverResultType": { "title": "Discover results", "enum": [ "releases", "artists" ], "type": "string", "description": "Releases gives one record per album or merch item. Artists and labels gives one record per account that posted them, once per run. A release put out by a label gives the label, since Discover names the artist without linking to them.", "default": "releases" }, "maxItems": { "title": "Maximum results per source", "minimum": 1, "type": "integer", "description": "Each start URL, search query and genre adds at most this many results. An artist URL counts the artist and the releases it opens. A result found twice is kept once.", "default": 100 }, "openResults": { "title": "Open search and Discover results", "type": "boolean", "description": "Opens each search or Discover result to get the full album, track or artist record (label, formats, tracklist, release date...) instead of the short result. For Discover artists and labels, it gives their full record (bio, links, releases list) without opening their releases. An account is a label when Bandcamp marks it as one or when most of its releases are by other artists.", "default": false }, "includeTracks": { "title": "Open each track of an album", "type": "boolean", "description": "Adds one record per track of each album, with its ISRC, lyrics and credits. The album record already lists its tracks with their durations.", "default": false }, "includeDiscography": { "title": "Open the discography of artists and labels", "type": "boolean", "description": "On an artist or label page, adds a record for each of their releases. Does not apply to artists and labels opened from Discover.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is recommended. Bandcamp may block many requests from one IP address.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }