{ "openapi": "3.0.1", "info": { "title": "Bandcamp Music Scraper", "description": "Scrapes album and track information from Bandcamp artist/label pages. Extracts album metadata, pricing, artwork, track listings, audio preview URLs, artist info, and embedded videos.", "version": "0.0", "x-build-id": "KDSrI3vHklpuJFumM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marielise.dev~bandcamp-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marielise.dev-bandcamp-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/marielise.dev~bandcamp-scraper/runs": { "post": { "operationId": "runs-sync-marielise.dev-bandcamp-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/marielise.dev~bandcamp-scraper/run-sync": { "post": { "operationId": "run-sync-marielise.dev-bandcamp-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": { "url": { "title": "Bandcamp Artist/Label URL", "type": "string", "description": "Bandcamp artist, label, album or track URL. Accepts artist and label subdomains (https://wardruna.bandcamp.com/), legacy custom domains that redirect to Bandcamp, and direct release URLs (https://wardruna.bandcamp.com/album/skald), which are scraped on their own instead of the whole discography.", "default": "https://wardruna.bandcamp.com/" }, "fetchAlbums": { "title": "Fetch Albums", "type": "boolean", "description": "Discover every release on the artist or label /music page. On its own this is the fast path and returns title, release URL and artwork. Release date, price, tags and download availability need Fetch Release Details.", "default": true }, "fetchAlbumDetails": { "title": "Fetch Release Details", "type": "boolean", "description": "Visit each release page to add release date, price and currency, genre tags and download availability. Implied by Fetch Track Listings and Fetch Embedded Videos. Adds roughly two seconds per release.", "default": false }, "fetchTracks": { "title": "Fetch Track Listings", "type": "boolean", "description": "Visit each release page and extract individual track listings with title, duration and track number. Implies Fetch Albums. Increases run time proportionally to the number of releases.", "default": false }, "fetchAudioPreviews": { "title": "Fetch Audio Preview URLs", "type": "boolean", "description": "Extract MP3 128kbps audio preview stream URLs for each track. Implies Fetch Track Listings.", "default": false }, "fetchArtistInfo": { "title": "Fetch Artist/Label Info", "type": "boolean", "description": "Extract the artist or label profile: biography, location, profile image, genre tags, and social links (website, Facebook, Instagram, Twitter/X, YouTube).", "default": false }, "fetchVideos": { "title": "Fetch Embedded Videos", "type": "boolean", "description": "Extract embedded video URLs (YouTube, Vimeo, Bandcamp) from album pages. Requires visiting each album page.", "default": false }, "maxAlbums": { "title": "Maximum Albums", "minimum": 0, "maximum": 500, "type": "integer", "description": "Limit the number of releases to process. Set to 0 for no limit. Large discographies are also bounded by the run timeout; the Actor stops early and reports a 'partial' status rather than timing out.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy configuration for bypassing rate limits or geo-restrictions. Use Apify Proxy or custom proxy URLs." } } }, "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 } } } } } } } } } }