# Bandcamp Music Scraper (`solidcode/bandcamp-music-scraper`) Actor \[💰 from $2 / 1K] Extract Bandcamp artists, labels, albums, tracks, and fans. Scrape full discographies, track listings with audio previews, prices, tags, and supporter lists from URLs, keyword search, or genre and location discovery. - **URL**: https://apify.com/solidcode/bandcamp-music-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Developer tools, E-commerce, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $12.00 / 1,000 albums This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bandcamp Music Scraper Pull artists, labels, albums, tracks, and fans from Bandcamp at scale — full discographies, normalized prices, release dates, genre tags, cover art, 30-second preview MP3 links, and supporter lists for every release. Paste a single artist URL and collect their entire catalog, search by keyword across four result kinds, or browse 27 Discover genres by location. Built for music marketers, A&R scouts, playlist curators, and music-data teams who need structured Bandcamp catalog data without clicking through hundreds of release pages by hand. ### Why This Scraper? - **Full discography from one URL** — paste a single artist or label page and collect every release in their catalog, even hundreds or thousands of titles, with no per-album links to assemble. - **30-second preview MP3 URLs on every track** — each track row carries a direct audio preview link plus duration and track number, ready to feed audio-analysis, fingerprinting, or playlist tools. - **27 Discover genres with location targeting** — browse trending releases from Electronic to Jazz to Ambient, narrowed to a place like Berlin, Tokyo, or Los Angeles, sorted by Best Selling, Newest Arrivals, or Surprise Me. - **Four keyword search modes** — one keyword returns matching artists & labels, albums, tracks, or fans — or all kinds at once — so you find catalog data without knowing the URL first. - **Supporter/fan lists most scrapers skip** — pull the fans who bought or wishlisted a release (username and profile link), up to 500 per release, a whole Bandcamp entity competitors omit. - **Normalized prices and currencies** — every album and track reports a clean major-unit price and 3-letter ISO currency, with name-your-price and free releases clearly flagged as no fixed price. - **Four record types in one dataset** — artist/label, album, track, and fan rows share one `recordType` field with dedicated table views, so you can filter and route each entity cleanly downstream. - **Artist & label profiles in full** — name, bio, self-reported location, genre tags, header image, social links, and release count, with a label flag to separate imprints from solo artists. - **Custom domains and *.bandcamp.com alike** — point it at a band's own domain or a Bandcamp subdomain and get the same structured catalog either way. ### Use Cases **Music Market Research** - Track which releases are best-selling in a genre week over week - Map a label's full catalog, release cadence, and pricing strategy - Compare genre trends across cities using location-targeted discovery - Benchmark independent pricing across albums, tracks, and name-your-price releases **A&R & Talent Scouting** - Surface newest arrivals in a genre to spot rising independent artists early - Pull an artist's complete discography to assess output and consistency - Find artists by location to scout regional scenes (e.g. Berlin techno, Tokyo city pop) - Build watchlists of artists from Artist Recommended Discover picks **Playlist & Catalog Building** - Collect 30-second preview URLs to audition tracks programmatically - Assemble themed catalogs by genre, location, or keyword search - Enrich a music database with cover art, release dates, and genre tags - Source independent tracks for licensing and sync libraries **Fan & Audience Analysis** - Pull supporter lists to understand who backs a release - Identify superfans who appear across an artist's multiple releases - Map an artist's audience overlap with peers in the same genre - Build outreach lists from fan profiles for community-building campaigns ### Getting Started #### Scrape One Album The simplest run — paste an album URL and get the release plus its full tracklist: ```json { "startUrls": ["https://machinegirl.bandcamp.com/album/wlfgrl"], "maxResults": 50 } ```` #### Crawl a Full Discography Point at an artist or label page to collect every release they have: ```json { "startUrls": ["https://machinegirl.bandcamp.com"], "includeTracks": true, "maxResults": 500 } ``` #### Search by Keyword Find albums matching a keyword without knowing any URLs: ```json { "searchTerms": ["lo-fi hip hop", "Aphex Twin"], "searchType": "albums", "maxResults": 100 } ``` #### Discover by Genre and Location Browse the best-selling ambient releases out of Berlin: ```json { "discoverGenre": "ambient", "discoverLocation": "berlin", "sortBy": "top", "maxResults": 200 } ``` #### Album with Supporters Pull one release and the fans who backed it: ```json { "startUrls": ["https://machinegirl.bandcamp.com/album/wlfgrl"], "includeFans": true, "maxResults": 600 } ``` ### Input Reference #### What to Scrape | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | string\[] | `["https://machinegirl.bandcamp.com"]` | Bandcamp links — the type is auto-detected. An artist or label page collects every release in their discography; an album or track page returns that release. Works for `*.bandcamp.com` and custom domains. | | `searchTerms` | string\[] | `[]` | Keywords to look up on Bandcamp — an artist name, album title, or genre. Each keyword returns matching results. | #### Search Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchType` | select | `All Types` | Which kind of result your keywords return: All Types, Artists & Labels, Albums, Tracks, or Fans. Applies only to Search Keywords. | #### Discovery Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `discoverGenre` | select | `None` | Browse trending releases in one of 27 genres (Electronic, Rock, Metal, Hip-Hop / Rap, Experimental, Ambient, Jazz, and more). Leave as None to skip genre discovery. | | `discoverLocation` | string | `""` | Narrow genre discovery to a place such as `berlin`, `tokyo`, or `los angeles`. Leave empty for worldwide results. Applies only when a genre is selected. | | `sortBy` | select | `Best Selling` | Order for genre discovery: Best Selling, Newest Arrivals, or Surprise Me. | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `100` | Maximum results across all URLs, searches, and discovery. Set to `0` for unlimited. Start with 10–50 to test, then increase. | | `includeTracks` | boolean | `true` | For each album, also return its full tracklist with titles, durations, track numbers, and 30-second preview links. Turn off for a lighter, album-only dataset. | | `includeFans` | boolean | `false` | For each album, also return the fans who bought or wishlisted it. Capped at 500 supporters per release to keep runs predictable. Leave off unless you need supporter data. | ### Output Every row carries a `recordType` field — `artist`, `album`, `track`, or `fan` — so you can filter each entity cleanly downstream. #### Artist / Label (`recordType: "artist"`) ```json { "recordType": "artist", "name": "Machine Girl", "isLabel": false, "bio": "Machine Girl is an American electronic music duo from Long Island, New York.", "location": "Long Island, NY", "imageUrl": "https://f4.bcbits.com/img/0012345678_10.jpg", "tags": [], "socialLinks": { "instagram": "https://instagram.com/machinegirlmusic", "twitter": "https://twitter.com/machinegirlz" }, "numAlbums": 14, "url": "https://machinegirl.bandcamp.com" } ``` | Field | Type | Description | |-------|------|-------------| | `recordType` | string | Always `"artist"` | | `name` | string | Artist or label name | | `isLabel` | boolean | `true` when the page is a label/imprint | | `bio` | string | Profile bio / about text | | `location` | string | Self-reported location | | `imageUrl` | string | Header / avatar image URL | | `tags` | string\[] | Genre tags | | `socialLinks` | object | External links keyed by site (website, instagram, twitter, youtube, etc.) | | `numAlbums` | number | Number of releases in the discography | | `url` | string | Profile URL | #### Album (`recordType: "album"`) ```json { "recordType": "album", "title": "WLFGRL", "artist": "Machine Girl", "type": "album", "url": "https://machinegirl.bandcamp.com/album/wlfgrl", "imageUrl": "https://f4.bcbits.com/img/a0012345678_10.jpg", "releaseDate": "21 Apr 2014 00:00:00 GMT", "priceAmount": 7.0, "currency": "USD", "downloadAvailable": true, "tags": ["breakcore", "electronic", "hardcore"], "numTracks": 11 } ``` | Field | Type | Description | |-------|------|-------------| | `recordType` | string | `"album"` | | `title` | string | Album title | | `artist` | string | Artist or label name | | `type` | string | Release type label from Bandcamp | | `url` | string | Release URL | | `imageUrl` | string | Cover art URL | | `releaseDate` | string | Release date | | `priceAmount` | number | Price as a major-unit float; `null` for name-your-price or free | | `currency` | string | 3-letter ISO currency code | | `downloadAvailable` | boolean | Whether a digital download is offered | | `tags` | string\[] | Genre tags | | `numTracks` | number | Number of tracks on the release | #### Track (`recordType: "track"`) Emitted for each track on an album when `includeTracks` is on, and for any track URL or track search hit. ```json { "recordType": "track", "title": "Ghost", "artist": "Machine Girl", "type": "track", "url": "https://machinegirl.bandcamp.com/track/ghost", "duration": 184.5, "trackNumber": 3, "previewUrl": "https://t4.bcbits.com/stream/abc123/mp3-128/456789", "albumTitle": "WLFGRL", "albumUrl": "https://machinegirl.bandcamp.com/album/wlfgrl", "currency": "USD", "tags": ["breakcore", "electronic"] } ``` | Field | Type | Description | |-------|------|-------------| | `recordType` | string | `"track"` | | `title` | string | Track title | | `artist` | string | Artist name | | `type` | string | Always `"track"` | | `url` | string | Track URL | | `duration` | number | Track length in seconds | | `trackNumber` | number | Position on the album (empty for a standalone single) | | `previewUrl` | string | Direct 30-second preview MP3 URL | | `albumTitle` | string | Parent album title (empty for a standalone single) | | `albumUrl` | string | Parent album URL (empty for a standalone single) | | `currency` | string | Price currency inherited from the release | | `tags` | string\[] | Genre tags inherited from the release | #### Fan / Supporter (`recordType: "fan"`) Emitted when Include Supporters is on (one row per supporter of a release, capped at 500 per release) and when you search with Search For set to Fans. ```json { "recordType": "fan", "username": "musiclover42", "name": "Alex R.", "url": "https://bandcamp.com/musiclover42", "releaseTitle": "WLFGRL", "releaseArtist": "Machine Girl", "releaseUrl": "https://machinegirl.bandcamp.com/album/wlfgrl" } ``` | Field | Type | Description | |-------|------|-------------| | `recordType` | string | `"fan"` | | `username` | string | Fan handle | | `name` | string | Display name | | `url` | string | Fan profile URL | | `releaseTitle` | string | Release the fan supports (empty for fans found via a keyword search, which aren't tied to a release) | | `releaseArtist` | string | Artist of the supported release (empty for keyword-search fans) | | `releaseUrl` | string | URL of the supported release (empty for keyword-search fans) | ### Tips for Best Results - **Start small.** Set `maxResults` to 10–50 on your first run to confirm the data matches your needs, then scale up. A single artist URL can fan out into hundreds of releases. - **Leave Include Supporters off unless you need fan lists.** Popular releases have thousands of supporters; even capped at 500 per release, fan rows can dominate a large run. Turn it on only when audience data is the goal. - **Turn off Include Track Listings for a lighter catalog.** When you only need album-level pricing and metadata, switching it off skips per-track rows and keeps runs lean. - **Use Newest Arrivals for A\&R scouting.** Setting `sortBy` to Newest surfaces fresh releases in a genre — the fastest way to spot rising independent artists before they break. - **Pair a genre with a location to scout regional scenes.** Discovery accepts a place name like `berlin` or `tokyo` alongside any of the 27 genres, so you can map a city's sound at a glance. - **Combine inputs in one run.** Mix several artist URLs, a few search keywords, and a genre discovery in a single invocation — pay for one start and get everything in one dataset. - **Filter by `recordType` downstream.** Each run mixes artists, albums, tracks, and fans; split by `recordType` to load each entity into the right table or sheet. ### Pricing **No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.** Pricing is by record type, so tracks and supporters cost a fraction of full albums and artist profiles. Bronze, Silver, and Gold subscribers pay progressively less; Gold is the everyday advertised price and the discount applies automatically on your account. | Record type | No discount | Bronze | Silver | Gold | |-------------|-------------|--------|--------|------| | Artist / label | $14.40 | $13.55 | $12.75 | **$12.00** | | Album | $14.40 | $13.55 | $12.75 | **$12.00** | | Track | $4.80 | $4.50 | $4.25 | **$4.00** | | Fan / supporter | $2.40 | $2.30 | $2.15 | **$2.00** | Prices are per 1,000 results of that type. Tracks ride along inside albums and supporters are optional, so you control the mix and the cost. #### Example Run Costs (Gold pricing) | What you run | Results produced | Cost | |--------------|------------------|------| | 100 albums, no track listings | 100 albums | $1.20 | | 100 albums + ~10 tracks each | 100 albums + 1,000 tracks | ~$5.20 | | 1,000 tracks via search | 1,000 tracks | $4.00 | | 50 artists + full discographies (~20 albums, ~10 tracks each) | 50 artists + 1,000 albums + 10,000 tracks | ~$52.60 | | 1 popular release + 500 supporters | 1 album + 500 fans | ~$1.01 | A "result" is any row in the output dataset. Track rows and supporter rows are billed at their own lower per-1,000 rates, so a run that skips track listings or supporters costs less. Platform fees (compute, storage) are additional and depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate music market research, catalog analysis, A\&R scouting, and audience intelligence. Users are responsible for complying with applicable laws and Bandcamp's terms of service, including making reasonable-rate requests and respecting copyright and usage rules for any audio, artwork, or text retrieved. Treat fan and supporter data as personal information: do not use it for spam, harassment, or any unlawful purpose. # Actor input Schema ## `startUrls` (type: `array`): Paste any Bandcamp links. The scraper auto-detects what each one is: an artist or label page (e.g. artistname.bandcamp.com), an album page (/album/...), or a single track (/track/...). For an artist or label page, every release on their discography is collected. (To collect fans, use the Include Supporters option below.) ## `searchTerms` (type: `array`): Words to look up on Bandcamp, such as an artist name, album title, or genre (e.g. 'lo-fi hip hop' or 'Aphex Twin'). Each keyword returns matching artists, albums, and tracks. No need to build URLs yourself. ## `searchType` (type: `string`): Which kind of result your keywords should return. Only applies to Search Keywords above. ## `discoverGenre` (type: `string`): Browse trending and recommended releases in a music genre, the way Bandcamp's Discover page works. Leave as 'None' to skip genre discovery. ## `discoverLocation` (type: `string`): Narrow genre discovery to releases tagged from a place, such as 'berlin', 'tokyo', or 'los angeles'. Leave empty for worldwide results. Only applies when a genre is selected above. ## `sortBy` (type: `string`): How to order genre discovery results. ## `maxResults` (type: `integer`): Maximum number of results to return across all URLs, searches, and discovery. Set to 0 for unlimited. Tip: start with 10-50 to test, then increase. ## `includeTracks` (type: `boolean`): For each release, also return its full track list with titles, durations, track numbers, and 30-second audio preview links. Turn off for a lighter dataset with release-level data only. ## `includeFans` (type: `boolean`): For each release, also return the fans who bought or wishlisted it (their username and profile link). Popular releases can have thousands of supporters, so to keep runs predictable this is capped at 500 supporters per release. Leave off unless you need supporter data. ## Actor input object example ```json { "startUrls": [ "https://machinegirl.bandcamp.com" ], "searchTerms": [], "searchType": "all", "discoverGenre": "none", "sortBy": "top", "maxResults": 100, "includeTracks": true, "includeFans": false } ``` # Actor output Schema ## `albums` (type: `string`): Albums and tracks with title, artist, price, release date, tags, and audio preview links. ## `artists` (type: `string`): Artist and label profiles with name, bio, location, and social links. ## `fans` (type: `string`): Supporter rows linking a fan to the release they bought or wishlisted (only present when 'Include Supporters' is enabled). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://machinegirl.bandcamp.com" ], "searchTerms": [], "searchType": "all", "discoverGenre": "none", "discoverLocation": "", "sortBy": "top", "maxResults": 100, "includeTracks": true, "includeFans": false }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/bandcamp-music-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://machinegirl.bandcamp.com"], "searchTerms": [], "searchType": "all", "discoverGenre": "none", "discoverLocation": "", "sortBy": "top", "maxResults": 100, "includeTracks": True, "includeFans": False, } # Run the Actor and wait for it to finish run = client.actor("solidcode/bandcamp-music-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://machinegirl.bandcamp.com" ], "searchTerms": [], "searchType": "all", "discoverGenre": "none", "discoverLocation": "", "sortBy": "top", "maxResults": 100, "includeTracks": true, "includeFans": false }' | apify call solidcode/bandcamp-music-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/bandcamp-music-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bandcamp Music Scraper", "description": "[💰 from $2 / 1K] Extract Bandcamp artists, labels, albums, tracks, and fans. Scrape full discographies, track listings with audio previews, prices, tags, and supporter lists from URLs, keyword search, or genre and location discovery.", "version": "1.0", "x-build-id": "TgZNd2aF3o9sMukeX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~bandcamp-music-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-bandcamp-music-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~bandcamp-music-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-bandcamp-music-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~bandcamp-music-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-bandcamp-music-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": { "startUrls": { "title": "Bandcamp URLs", "type": "array", "description": "Paste any Bandcamp links. The scraper auto-detects what each one is: an artist or label page (e.g. artistname.bandcamp.com), an album page (/album/...), or a single track (/track/...). For an artist or label page, every release on their discography is collected. (To collect fans, use the Include Supporters option below.)", "items": { "type": "string" } }, "searchTerms": { "title": "Search Keywords", "type": "array", "description": "Words to look up on Bandcamp, such as an artist name, album title, or genre (e.g. 'lo-fi hip hop' or 'Aphex Twin'). Each keyword returns matching artists, albums, and tracks. No need to build URLs yourself.", "items": { "type": "string" } }, "searchType": { "title": "Search For", "enum": [ "all", "artists_labels", "albums", "tracks", "fans" ], "type": "string", "description": "Which kind of result your keywords should return. Only applies to Search Keywords above.", "default": "all" }, "discoverGenre": { "title": "Discover by Genre", "enum": [ "none", "electronic", "rock", "metal", "alternative", "hip-hop-rap", "experimental", "punk", "folk", "pop", "ambient", "soundtrack", "world", "jazz", "acoustic", "funk", "r-b-soul", "devotional", "classical", "reggae", "podcasts", "country", "spoken-word", "comedy", "blues", "kids", "audiobooks", "latin" ], "type": "string", "description": "Browse trending and recommended releases in a music genre, the way Bandcamp's Discover page works. Leave as 'None' to skip genre discovery.", "default": "none" }, "discoverLocation": { "title": "Discover by Location", "type": "string", "description": "Narrow genre discovery to releases tagged from a place, such as 'berlin', 'tokyo', or 'los angeles'. Leave empty for worldwide results. Only applies when a genre is selected above." }, "sortBy": { "title": "Sort Discovery By", "enum": [ "top", "new", "rand" ], "type": "string", "description": "How to order genre discovery results.", "default": "top" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of results to return across all URLs, searches, and discovery. Set to 0 for unlimited. Tip: start with 10-50 to test, then increase.", "default": 100 }, "includeTracks": { "title": "Include Track Listings", "type": "boolean", "description": "For each release, also return its full track list with titles, durations, track numbers, and 30-second audio preview links. Turn off for a lighter dataset with release-level data only.", "default": true }, "includeFans": { "title": "Include Supporters", "type": "boolean", "description": "For each release, also return the fans who bought or wishlisted it (their username and profile link). Popular releases can have thousands of supporters, so to keep runs predictable this is capped at 500 supporters per release. Leave off unless you need supporter data.", "default": false } } }, "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 } } } } } } } } } } ```