{
  "data": {
    "id": "d02No4P3NyfVbrlUU",
    "actId": "Ubjt6aJQtdEXl2jpL",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-21T09:45:30.782Z",
    "finishedAt": "2026-11-21T09:45:40.733Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 9855,
      "runTimeSecs": 9.855,
      "computeUnits": 0.01095,
      "imageSizeBytes": 358362624
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Bandcamp Scraper Input\",\n  \"description\": \"Search Bandcamp, fetch albums/tracks/artists/labels by URL, or browse by tag/genre or the discover feed.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch. Search, fetch by URL, list an artist/label full discography, browse a tag/genre, or read the discover feed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"byUrl\",\n        \"searchAlbum\",\n        \"searchTrack\",\n        \"searchArtist\",\n        \"searchBand\",\n        \"searchLabel\",\n        \"byArtist\",\n        \"byDiscography\",\n        \"byAlbum\",\n        \"byTrack\",\n        \"byTag\",\n        \"byGenre\",\n        \"discover\"\n      ],\n      \"enumTitles\": [\n        \"By URL (auto-route bandcamp.com URLs)\",\n        \"Search albums\",\n        \"Search tracks\",\n        \"Search artists\",\n        \"Search bands (alias of searchArtist)\",\n        \"Search labels\",\n        \"By artist (full catalog)\",\n        \"By discography (one record per release)\",\n        \"By album\",\n        \"By track\",\n        \"By tag\",\n        \"By genre (alias of byTag)\",\n        \"Discover feed\"\n      ],\n      \"default\": \"byUrl\",\n      \"prefill\": \"byUrl\"\n    },\n    \"url\": {\n      \"title\": \"URL\",\n      \"type\": \"string\",\n      \"description\": \"A bandcamp.com URL — album, track, artist subdomain, tag page, search URL, or the discover front page. Used by mode=byUrl/byAlbum/byTrack/byArtist/byDiscography.\",\n      \"editor\": \"textfield\",\n      \"default\": \"https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven\",\n      \"prefill\": \"https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven\",\n      \"sectionCaption\": \"URL & search inputs\",\n      \"sectionDescription\": \"URLs (single or batch) plus the keyword used by the search* modes.\"\n    },\n    \"urls\": {\n      \"title\": \"URLs (mode=byUrl, batch)\",\n      \"type\": \"array\",\n      \"description\": \"Multiple bandcamp.com URLs. Album/track/artist/tag URLs are auto-routed.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"query\": {\n      \"title\": \"Search query (mode=search*)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text query for the search modes.\",\n      \"editor\": \"textfield\",\n      \"default\": \"ambient\",\n      \"prefill\": \"ambient\"\n    },\n    \"artistSubdomain\": {\n      \"title\": \"Artist subdomain (mode=byArtist/byAlbum/byTrack)\",\n      \"type\": \"string\",\n      \"description\": \"Artist subdomain on bandcamp.com (the part before `.bandcamp.com`). Combine with `albumSlug` or `trackSlug` to build a URL.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Slug inputs (mode=byArtist / byAlbum / byTrack / byTag)\",\n      \"sectionDescription\": \"Slug-based inputs the actor uses to build a Bandcamp URL when you don't pass a full URL.\"\n    },\n    \"artistUrl\": {\n      \"title\": \"Artist or label URL (mode=byArtist/byDiscography)\",\n      \"type\": \"string\",\n      \"description\": \"Full URL of an artist or label homepage. byArtist reads the profile; byDiscography lists every release on its /music page.\",\n      \"editor\": \"textfield\"\n    },\n    \"enrichDiscography\": {\n      \"title\": \"Fetch full release details (mode=byDiscography)\",\n      \"type\": \"boolean\",\n      \"description\": \"For every release in the discography, also open its album/track page to fill tracklists, pricing, tags, and audio links. Slower (one request per release); off uses the fast /music grid.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"albumSlug\": {\n      \"title\": \"Album slug (mode=byAlbum)\",\n      \"type\": \"string\",\n      \"description\": \"Album slug — the part after `/album/` in the URL.\",\n      \"editor\": \"textfield\"\n    },\n    \"trackSlug\": {\n      \"title\": \"Track slug (mode=byTrack)\",\n      \"type\": \"string\",\n      \"description\": \"Track slug — the part after `/track/` in the URL.\",\n      \"editor\": \"textfield\"\n    },\n    \"tag\": {\n      \"title\": \"Tag (mode=byTag)\",\n      \"type\": \"string\",\n      \"description\": \"Bandcamp tag slug, e.g. `electronic`, `lo-fi`, `synthwave`.\",\n      \"editor\": \"textfield\"\n    },\n    \"genre\": {\n      \"title\": \"Genre (mode=byGenre / discover)\",\n      \"type\": \"string\",\n      \"description\": \"One of the curated Bandcamp top-level genres. Used by mode=byGenre and mode=discover.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"electronic\",\n        \"rock\",\n        \"metal\",\n        \"alternative\",\n        \"hip-hop-rap\",\n        \"experimental\",\n        \"punk\",\n        \"folk\",\n        \"pop\",\n        \"ambient\",\n        \"soundtrack\",\n        \"world\",\n        \"jazz\",\n        \"acoustic\",\n        \"funk\",\n        \"r-and-b-soul\",\n        \"devotional\",\n        \"classical\",\n        \"reggae\",\n        \"podcasts\",\n        \"country\",\n        \"spoken-word\",\n        \"comedy\",\n        \"blues\",\n        \"kids\",\n        \"audiobooks\",\n        \"latin\"\n      ],\n      \"enumTitles\": [\n        \"All genres\",\n        \"Electronic\",\n        \"Rock\",\n        \"Metal\",\n        \"Alternative\",\n        \"Hip-Hop / Rap\",\n        \"Experimental\",\n        \"Punk\",\n        \"Folk\",\n        \"Pop\",\n        \"Ambient\",\n        \"Soundtrack\",\n        \"World\",\n        \"Jazz\",\n        \"Acoustic\",\n        \"Funk\",\n        \"R&B / Soul\",\n        \"Devotional\",\n        \"Classical\",\n        \"Reggae\",\n        \"Podcasts\",\n        \"Country\",\n        \"Spoken Word\",\n        \"Comedy\",\n        \"Blues\",\n        \"Kids\",\n        \"Audiobooks\",\n        \"Latin\"\n      ]\n    },\n    \"sortBy\": {\n      \"title\": \"Sort (mode=discover)\",\n      \"type\": \"string\",\n      \"description\": \"Sort order for the discover feed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"top\",\n        \"new\",\n        \"rec\"\n      ],\n      \"enumTitles\": [\n        \"Top (popular)\",\n        \"New releases\",\n        \"Recommended\"\n      ],\n      \"default\": \"top\",\n      \"prefill\": \"top\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price (USD)\",\n      \"type\": \"number\",\n      \"description\": \"Drop records with a listed price below this value. Records without pricing data pass.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 1000,\n      \"sectionCaption\": \"Result filters\",\n      \"sectionDescription\": \"Drop records that don't match these criteria. Records without pricing data pass through min/max price.\"\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price (USD)\",\n      \"type\": \"number\",\n      \"description\": \"Drop records with a listed price above this value. Records without pricing data pass.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 1000\n    },\n    \"onlyWithAudio\": {\n      \"title\": \"Audio stream required\",\n      \"type\": \"boolean\",\n      \"description\": \"Only emit records that have a streamable audio URL or featured track.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"onlyFree\": {\n      \"title\": \"Only free items\",\n      \"type\": \"boolean\",\n      \"description\": \"Only emit records that are name-your-price-zero or explicitly free.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"useProxy\": {\n      \"title\": \"Use Apify proxy\",\n      \"type\": \"boolean\",\n      \"description\": \"Route requests through Apify proxy. Bandcamp is normally accessible without a proxy.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false,\n      \"sectionCaption\": \"Proxy & escalation\",\n      \"sectionDescription\": \"Optional Apify proxy. Auto-escalation transparently retries through proxy on 403/429.\"\n    },\n    \"autoEscalateOnBlock\": {\n      \"title\": \"Auto-escalate to proxy on block\",\n      \"type\": \"boolean\",\n      \"description\": \"If direct fetches return 403/429, retry through Apify proxy automatically.\",\n      \"editor\": \"checkbox\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"proxyConfiguration\": {\n      \"title\": \"Proxy configuration\",\n      \"type\": \"object\",\n      \"description\": \"Optional Apify proxy configuration override.\",\n      \"editor\": \"proxy\",\n      \"default\": {\n        \"useApifyProxy\": true,\n        \"apifyProxyGroups\": []\n      },\n      \"prefill\": {\n        \"useApifyProxy\": true,\n        \"apifyProxyGroups\": []\n      }\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 50,\n      \"prefill\": 50,\n      \"sectionCaption\": \"Output cap\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Bandcamp Album, Track & Discography Extractor\n\nPull structured release data straight from Bandcamp — the pay-what-you-want home of independent music. Point it at an album, track, or artist page, run a keyword search, browse a tag/genre hub, or pull the front-page discover feed, and get back clean records with pricing, tracklists, and audio preview links instead of raw HTML.\n\n## What this actor does\n\n- Fetches a single Bandcamp page by URL, or a batch of mixed album/track/artist/tag URLs in one run, auto-routing each to the right parser\n- Searches Bandcamp's own index for albums, tracks, artists/bands, or labels by keyword\n- Lists an artist's or label's full discography from its `/music` page — one record per release, with an optional full-detail pass per release\n- Browses a tag or top-level genre hub, or the front-page discover feed sorted by top/new/recommended\n- Filters results by minimum/maximum price or to only free/name-your-price items before they're returned\n- Omits any field that has no value for a given record rather than returning it empty or null\n\n## Output per record\n\nEvery record carries `recordType` (`album`, `track`, `artist`, or `label`), a canonical `url`, `scrapedAt`, and `siteName`. What else is present depends on what was fetched:\n\n**Albums**\n- `title`, `description`, `credits`, `releaseType`\n- `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`\n- `coverUrl`, `coverUrlOriginal` — cover artwork\n- `numTracks`, `tracks[]` — each with `title`, `trackNumber`, `duration`, `durationSeconds`, `trackId`, `streamUrl`, `lyrics`\n- `releaseDate`, `originalReleaseDate`\n- `tags[]` — up to 30 Bandcamp tags\n- `price`, `minimumPrice`, `currency`, `isFree`\n- `upc`, `formats[]` — physical/digital editions with `formatName`, `title`, `price`, `currency`, `upc`, `sku`, `available`\n- `hasAudio`, `isPreorder`\n- `albumId`, `artId`, `featuredTrackId`, `bandId`\n\n**Tracks**\n- `title`, `description`, `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`\n- `albumTitle`, `albumUrl`, `albumId`, `trackNumber`\n- `coverUrl`, `coverUrlOriginal`, `duration`, `durationSeconds`, `streamUrl`, `lyrics`\n- `releaseDate`, `tags[]`, `price`, `currency`, `trackId`, `isrc`, `credits`, `licenseName`, `bandId`\n\n**Artists / labels**\n- `name`, `description`, `location`, `url`, `imageUrl`, `bandId`\n- `isLabel`, `currency`, `links[]` — the artist's own linked sites\n- `discography[]` — each with `title`, `artist`, `type`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`\n- `discographyCount`\n\n**Discography mode (`byDiscography`)**\n- One `album` or `track` record per release: `title`, `artistName`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`\n- With `enrichDiscography: true`, each record is replaced by the full album/track record above (tracklist, price, tags, audio stream, and so on)\n\n**Search, tag, genre & discover results**\n- `title` or `name`, `artistName`, `artistUrl`, `coverUrl`, `imageUrl`\n- `albumId` / `trackId` / `bandId`\n- `tags[]` — search results only\n- `genre`, `location`, `releaseDate`, `artistImageUrl`, `featuredTrack` — present on discover/tag/genre results, with `title`, `trackId`, `durationSeconds`, `streamUrl`\n- Tag results from the search fallback also include the `tags[]` that matched the requested tag\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `byUrl` | What to fetch: `byUrl`, `searchAlbum`, `searchTrack`, `searchArtist`, `searchBand`, `searchLabel`, `byArtist`, `byDiscography`, `byAlbum`, `byTrack`, `byTag`, `byGenre`, `discover` |\n| `url` | string | `https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven` | A single bandcamp.com URL (used by `byUrl`/`byAlbum`/`byTrack`/`byArtist`/`byDiscography`) |\n| `urls` | array | `[]` | Multiple bandcamp.com URLs for a batch `byUrl` run |\n| `query` | string | `ambient` | Keyword for the search modes |\n| `artistSubdomain` | string | – | Artist subdomain (the part before `.bandcamp.com`), combined with `albumSlug`/`trackSlug` |\n| `artistUrl` | string | – | Full artist or label homepage URL (`mode=byArtist`/`byDiscography`) |\n| `enrichDiscography` | boolean | `false` | Open each release's album/track page for full details (`mode=byDiscography`); off reads the fast `/music` grid only |\n| `albumSlug` | string | – | Album slug, the part after `/album/` (`mode=byAlbum`) |\n| `trackSlug` | string | – | Track slug, the part after `/track/` (`mode=byTrack`) |\n| `tag` | string | – | Tag slug, e.g. `electronic`, `lo-fi` (`mode=byTag`) |\n| `genre` | string (select) | – | Curated top-level genre (`mode=byGenre`/`discover`) |\n| `sortBy` | string (select) | `top` | Discover feed order: `top`, `new`, or `rec` (`mode=discover`) |\n| `minPrice` | number | – | Drop records priced below this many USD; unpriced records still pass |\n| `maxPrice` | number | – | Drop records priced above this many USD; unpriced records still pass |\n| `onlyWithAudio` | boolean | `false` | Keep only records with a streamable audio URL or featured track |\n| `onlyFree` | boolean | `false` | Keep only free / name-your-price-zero items |\n| `useProxy` | boolean | `false` | Route requests through Apify proxy |\n| `autoEscalateOnBlock` | boolean | `true` | Automatically retry through proxy if a direct request is blocked |\n| `proxyConfiguration` | object | `{\"useApifyProxy\": true, \"apifyProxyGroups\": []}` | Optional proxy configuration override |\n| `maxItems` | integer | `50` | Hard cap on the number of records returned (1-1000) |\n\n### Example: fetch a specific album\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"url\": \"https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven\"\n}\n```\n\n### Example: list an artist's full discography\n\n```json\n{\n  \"mode\": \"byDiscography\",\n  \"artistUrl\": \"https://godspeedyoublackemperor.bandcamp.com/\",\n  \"enrichDiscography\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: search for albums by keyword\n\n```json\n{\n  \"mode\": \"searchAlbum\",\n  \"query\": \"ambient\",\n  \"maxItems\": 30\n}\n```\n\n### Example: browse a tag, filtered to free releases\n\n```json\n{\n  \"mode\": \"byTag\",\n  \"tag\": \"lo-fi\",\n  \"onlyFree\": true,\n  \"maxItems\": 40\n}\n```\n\n### Example: discover feed, new electronic releases\n\n```json\n{\n  \"mode\": \"discover\",\n  \"genre\": \"electronic\",\n  \"sortBy\": \"new\",\n  \"maxItems\": 25\n}\n```\n\n## Use cases\n\n- Music blogs and playlisters tracking new releases in a genre or tag\n- Labels and artists monitoring how their own catalog appears on Bandcamp\n- Fans building a complete, up-to-date list of an artist's discography\n- Researchers studying tag/genre trends or pricing patterns across independent music\n- Developers building a Bandcamp-backed search or recommendation index\n- Crate-diggers filtering releases down to free or pay-what-you-want items\n\n## FAQ\n\n**Do I need a Bandcamp account to use this?**\nNo. Every mode reads pages and endpoints that Bandcamp already serves publicly.\n\n**Does this actor download the actual audio files?**\nNo. Track records include `streamUrl`, a link to the short preview stream Bandcamp itself serves; the actor doesn't fetch or store the audio bytes.\n\n**Can it scrape a fan's collection or profile page?**\nNo — fan profiles sit behind a Bandcamp login and aren't covered by any mode here.\n\n**What's the difference between `byTag` and `byGenre`?**\n`byGenre` is `byTag` scoped to Bandcamp's curated top-level genre list. Canonical genres read Bandcamp's discover feed; any other tag uses Bandcamp's search index and keeps only releases whose own tags match, so the first page is capped at the search index's top 50 albums and top 50 tracks.\n\n**How complete is a discography?**\n`byDiscography` reads the releases Bandcamp lists on the artist's or label's `/music` page. `enrichDiscography` then opens each release page, so the record has the same depth as `byAlbum`/`byTrack`.\n\n**Why do `price` or `minimumPrice` sometimes not appear?**\nMany Bandcamp releases are name-your-price. If no price floor is set at all, neither field is produced; `isFree` is set instead when the item is genuinely free.\n\n**Why is `lyrics` or `duration` missing from some tracks?**\nThose come straight from what the artist entered on Bandcamp. If a track has no lyrics transcript or no playable preview, the field is left out rather than sent empty.\n\n**How current is the data?**\nAlbum, track, and artist pages reflect whatever is live on Bandcamp at the moment of the request; the discover feed and search index are Bandcamp's own near-real-time results.\n\n**Will `minPrice`/`maxPrice` filter out free releases?**\nFree releases are treated as price 0, so a positive `minPrice` drops them. Records with no pricing data at all (search/artist listings) pass the price filters unchanged.\n\n**Is this affiliated with Bandcamp?**\nNo. This is an independent tool that reads Bandcamp's publicly accessible pages and search results.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "bandcamp-album-track-and-discography-extractor",
      "title": "Bandcamp Album, Track & Discography Extractor",
      "description": "Pull Bandcamp album, track, and artist records with tracklists, pricing, tags, and cover art, or browse a tag, genre, or the discover feed for new independent releases.",
      "version": "1.0",
      "categories": [
        "ECOMMERCE",
        "OTHER"
      ],
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# Bandcamp Album, Track & Discography Extractor\n\nPull structured release data straight from Bandcamp — the pay-what-you-want home of independent music. Point it at an album, track, or artist page, run a keyword search, browse a tag/genre hub, or pull the front-page discover feed, and get back clean records with pricing, tracklists, and audio preview links instead of raw HTML.\n\n## What this actor does\n\n- Fetches a single Bandcamp page by URL, or a batch of mixed album/track/artist/tag URLs in one run, auto-routing each to the right parser\n- Searches Bandcamp's own index for albums, tracks, artists/bands, or labels by keyword\n- Lists an artist's or label's full discography from its `/music` page — one record per release, with an optional full-detail pass per release\n- Browses a tag or top-level genre hub, or the front-page discover feed sorted by top/new/recommended\n- Filters results by minimum/maximum price or to only free/name-your-price items before they're returned\n- Omits any field that has no value for a given record rather than returning it empty or null\n\n## Output per record\n\nEvery record carries `recordType` (`album`, `track`, `artist`, or `label`), a canonical `url`, `scrapedAt`, and `siteName`. What else is present depends on what was fetched:\n\n**Albums**\n- `title`, `description`, `credits`, `releaseType`\n- `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`\n- `coverUrl`, `coverUrlOriginal` — cover artwork\n- `numTracks`, `tracks[]` — each with `title`, `trackNumber`, `duration`, `durationSeconds`, `trackId`, `streamUrl`, `lyrics`\n- `releaseDate`, `originalReleaseDate`\n- `tags[]` — up to 30 Bandcamp tags\n- `price`, `minimumPrice`, `currency`, `isFree`\n- `upc`, `formats[]` — physical/digital editions with `formatName`, `title`, `price`, `currency`, `upc`, `sku`, `available`\n- `hasAudio`, `isPreorder`\n- `albumId`, `artId`, `featuredTrackId`, `bandId`\n\n**Tracks**\n- `title`, `description`, `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`\n- `albumTitle`, `albumUrl`, `albumId`, `trackNumber`\n- `coverUrl`, `coverUrlOriginal`, `duration`, `durationSeconds`, `streamUrl`, `lyrics`\n- `releaseDate`, `tags[]`, `price`, `currency`, `trackId`, `isrc`, `credits`, `licenseName`, `bandId`\n\n**Artists / labels**\n- `name`, `description`, `location`, `url`, `imageUrl`, `bandId`\n- `isLabel`, `currency`, `links[]` — the artist's own linked sites\n- `discography[]` — each with `title`, `artist`, `type`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`\n- `discographyCount`\n\n**Discography mode (`byDiscography`)**\n- One `album` or `track` record per release: `title`, `artistName`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`\n- With `enrichDiscography: true`, each record is replaced by the full album/track record above (tracklist, price, tags, audio stream, and so on)\n\n**Search, tag, genre & discover results**\n- `title` or `name`, `artistName`, `artistUrl`, `coverUrl`, `imageUrl`\n- `albumId` / `trackId` / `bandId`\n- `tags[]` — search results only\n- `genre`, `location`, `releaseDate`, `artistImageUrl`, `featuredTrack` — present on discover/tag/genre results, with `title`, `trackId`, `durationSeconds`, `streamUrl`\n- Tag results from the search fallback also include the `tags[]` that matched the requested tag\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `byUrl` | What to fetch: `byUrl`, `searchAlbum`, `searchTrack`, `searchArtist`, `searchBand`, `searchLabel`, `byArtist`, `byDiscography`, `byAlbum`, `byTrack`, `byTag`, `byGenre`, `discover` |\n| `url` | string | `https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven` | A single bandcamp.com URL (used by `byUrl`/`byAlbum`/`byTrack`/`byArtist`/`byDiscography`) |\n| `urls` | array | `[]` | Multiple bandcamp.com URLs for a batch `byUrl` run |\n| `query` | string | `ambient` | Keyword for the search modes |\n| `artistSubdomain` | string | – | Artist subdomain (the part before `.bandcamp.com`), combined with `albumSlug`/`trackSlug` |\n| `artistUrl` | string | – | Full artist or label homepage URL (`mode=byArtist`/`byDiscography`) |\n| `enrichDiscography` | boolean | `false` | Open each release's album/track page for full details (`mode=byDiscography`); off reads the fast `/music` grid only |\n| `albumSlug` | string | – | Album slug, the part after `/album/` (`mode=byAlbum`) |\n| `trackSlug` | string | – | Track slug, the part after `/track/` (`mode=byTrack`) |\n| `tag` | string | – | Tag slug, e.g. `electronic`, `lo-fi` (`mode=byTag`) |\n| `genre` | string (select) | – | Curated top-level genre (`mode=byGenre`/`discover`) |\n| `sortBy` | string (select) | `top` | Discover feed order: `top`, `new`, or `rec` (`mode=discover`) |\n| `minPrice` | number | – | Drop records priced below this many USD; unpriced records still pass |\n| `maxPrice` | number | – | Drop records priced above this many USD; unpriced records still pass |\n| `onlyWithAudio` | boolean | `false` | Keep only records with a streamable audio URL or featured track |\n| `onlyFree` | boolean | `false` | Keep only free / name-your-price-zero items |\n| `useProxy` | boolean | `false` | Route requests through Apify proxy |\n| `autoEscalateOnBlock` | boolean | `true` | Automatically retry through proxy if a direct request is blocked |\n| `proxyConfiguration` | object | `{\"useApifyProxy\": true, \"apifyProxyGroups\": []}` | Optional proxy configuration override |\n| `maxItems` | integer | `50` | Hard cap on the number of records returned (1-1000) |\n\n### Example: fetch a specific album\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"url\": \"https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven\"\n}\n```\n\n### Example: list an artist's full discography\n\n```json\n{\n  \"mode\": \"byDiscography\",\n  \"artistUrl\": \"https://godspeedyoublackemperor.bandcamp.com/\",\n  \"enrichDiscography\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: search for albums by keyword\n\n```json\n{\n  \"mode\": \"searchAlbum\",\n  \"query\": \"ambient\",\n  \"maxItems\": 30\n}\n```\n\n### Example: browse a tag, filtered to free releases\n\n```json\n{\n  \"mode\": \"byTag\",\n  \"tag\": \"lo-fi\",\n  \"onlyFree\": true,\n  \"maxItems\": 40\n}\n```\n\n### Example: discover feed, new electronic releases\n\n```json\n{\n  \"mode\": \"discover\",\n  \"genre\": \"electronic\",\n  \"sortBy\": \"new\",\n  \"maxItems\": 25\n}\n```\n\n## Use cases\n\n- Music blogs and playlisters tracking new releases in a genre or tag\n- Labels and artists monitoring how their own catalog appears on Bandcamp\n- Fans building a complete, up-to-date list of an artist's discography\n- Researchers studying tag/genre trends or pricing patterns across independent music\n- Developers building a Bandcamp-backed search or recommendation index\n- Crate-diggers filtering releases down to free or pay-what-you-want items\n\n## FAQ\n\n**Do I need a Bandcamp account to use this?**\nNo. Every mode reads pages and endpoints that Bandcamp already serves publicly.\n\n**Does this actor download the actual audio files?**\nNo. Track records include `streamUrl`, a link to the short preview stream Bandcamp itself serves; the actor doesn't fetch or store the audio bytes.\n\n**Can it scrape a fan's collection or profile page?**\nNo — fan profiles sit behind a Bandcamp login and aren't covered by any mode here.\n\n**What's the difference between `byTag` and `byGenre`?**\n`byGenre` is `byTag` scoped to Bandcamp's curated top-level genre list. Canonical genres read Bandcamp's discover feed; any other tag uses Bandcamp's search index and keeps only releases whose own tags match, so the first page is capped at the search index's top 50 albums and top 50 tracks.\n\n**How complete is a discography?**\n`byDiscography` reads the releases Bandcamp lists on the artist's or label's `/music` page. `enrichDiscography` then opens each release page, so the record has the same depth as `byAlbum`/`byTrack`.\n\n**Why do `price` or `minimumPrice` sometimes not appear?**\nMany Bandcamp releases are name-your-price. If no price floor is set at all, neither field is produced; `isFree` is set instead when the item is genuinely free.\n\n**Why is `lyrics` or `duration` missing from some tracks?**\nThose come straight from what the artist entered on Bandcamp. If a track has no lyrics transcript or no playable preview, the field is left out rather than sent empty.\n\n**How current is the data?**\nAlbum, track, and artist pages reflect whatever is live on Bandcamp at the moment of the request; the discover feed and search index are Bandcamp's own near-real-time results.\n\n**Will `minPrice`/`maxPrice` filter out free releases?**\nFree releases are treated as price 0, so a positive `minPrice` drops them. Records with no pricing data at all (search/artist listings) pass the price filters unchanged.\n\n**Is this affiliated with Bandcamp?**\nNo. This is an independent tool that reads Bandcamp's publicly accessible pages and search results.\n",
      "input": {
        "title": "Bandcamp Scraper Input",
        "description": "Search Bandcamp, fetch albums/tracks/artists/labels by URL, or browse by tag/genre or the discover feed.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch. Search, fetch by URL, list an artist/label full discography, browse a tag/genre, or read the discover feed.",
            "editor": "select",
            "enum": [
              "byUrl",
              "searchAlbum",
              "searchTrack",
              "searchArtist",
              "searchBand",
              "searchLabel",
              "byArtist",
              "byDiscography",
              "byAlbum",
              "byTrack",
              "byTag",
              "byGenre",
              "discover"
            ],
            "enumTitles": [
              "By URL (auto-route bandcamp.com URLs)",
              "Search albums",
              "Search tracks",
              "Search artists",
              "Search bands (alias of searchArtist)",
              "Search labels",
              "By artist (full catalog)",
              "By discography (one record per release)",
              "By album",
              "By track",
              "By tag",
              "By genre (alias of byTag)",
              "Discover feed"
            ],
            "default": "byUrl",
            "prefill": "byUrl"
          },
          "url": {
            "title": "URL",
            "type": "string",
            "description": "A bandcamp.com URL — album, track, artist subdomain, tag page, search URL, or the discover front page. Used by mode=byUrl/byAlbum/byTrack/byArtist/byDiscography.",
            "editor": "textfield",
            "default": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
            "prefill": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
            "sectionCaption": "URL & search inputs",
            "sectionDescription": "URLs (single or batch) plus the keyword used by the search* modes."
          },
          "urls": {
            "title": "URLs (mode=byUrl, batch)",
            "type": "array",
            "description": "Multiple bandcamp.com URLs. Album/track/artist/tag URLs are auto-routed.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "query": {
            "title": "Search query (mode=search*)",
            "type": "string",
            "description": "Free-text query for the search modes.",
            "editor": "textfield",
            "default": "ambient",
            "prefill": "ambient"
          },
          "artistSubdomain": {
            "title": "Artist subdomain (mode=byArtist/byAlbum/byTrack)",
            "type": "string",
            "description": "Artist subdomain on bandcamp.com (the part before `.bandcamp.com`). Combine with `albumSlug` or `trackSlug` to build a URL.",
            "editor": "textfield",
            "sectionCaption": "Slug inputs (mode=byArtist / byAlbum / byTrack / byTag)",
            "sectionDescription": "Slug-based inputs the actor uses to build a Bandcamp URL when you don't pass a full URL."
          },
          "artistUrl": {
            "title": "Artist or label URL (mode=byArtist/byDiscography)",
            "type": "string",
            "description": "Full URL of an artist or label homepage. byArtist reads the profile; byDiscography lists every release on its /music page.",
            "editor": "textfield"
          },
          "enrichDiscography": {
            "title": "Fetch full release details (mode=byDiscography)",
            "type": "boolean",
            "description": "For every release in the discography, also open its album/track page to fill tracklists, pricing, tags, and audio links. Slower (one request per release); off uses the fast /music grid.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "albumSlug": {
            "title": "Album slug (mode=byAlbum)",
            "type": "string",
            "description": "Album slug — the part after `/album/` in the URL.",
            "editor": "textfield"
          },
          "trackSlug": {
            "title": "Track slug (mode=byTrack)",
            "type": "string",
            "description": "Track slug — the part after `/track/` in the URL.",
            "editor": "textfield"
          },
          "tag": {
            "title": "Tag (mode=byTag)",
            "type": "string",
            "description": "Bandcamp tag slug, e.g. `electronic`, `lo-fi`, `synthwave`.",
            "editor": "textfield"
          },
          "genre": {
            "title": "Genre (mode=byGenre / discover)",
            "type": "string",
            "description": "One of the curated Bandcamp top-level genres. Used by mode=byGenre and mode=discover.",
            "editor": "select",
            "enum": [
              "all",
              "electronic",
              "rock",
              "metal",
              "alternative",
              "hip-hop-rap",
              "experimental",
              "punk",
              "folk",
              "pop",
              "ambient",
              "soundtrack",
              "world",
              "jazz",
              "acoustic",
              "funk",
              "r-and-b-soul",
              "devotional",
              "classical",
              "reggae",
              "podcasts",
              "country",
              "spoken-word",
              "comedy",
              "blues",
              "kids",
              "audiobooks",
              "latin"
            ],
            "enumTitles": [
              "All genres",
              "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"
            ]
          },
          "sortBy": {
            "title": "Sort (mode=discover)",
            "type": "string",
            "description": "Sort order for the discover feed.",
            "editor": "select",
            "enum": [
              "top",
              "new",
              "rec"
            ],
            "enumTitles": [
              "Top (popular)",
              "New releases",
              "Recommended"
            ],
            "default": "top",
            "prefill": "top"
          },
          "minPrice": {
            "title": "Minimum price (USD)",
            "type": "number",
            "description": "Drop records with a listed price below this value. Records without pricing data pass.",
            "editor": "number",
            "minimum": 0,
            "maximum": 1000,
            "sectionCaption": "Result filters",
            "sectionDescription": "Drop records that don't match these criteria. Records without pricing data pass through min/max price."
          },
          "maxPrice": {
            "title": "Maximum price (USD)",
            "type": "number",
            "description": "Drop records with a listed price above this value. Records without pricing data pass.",
            "editor": "number",
            "minimum": 0,
            "maximum": 1000
          },
          "onlyWithAudio": {
            "title": "Audio stream required",
            "type": "boolean",
            "description": "Only emit records that have a streamable audio URL or featured track.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "onlyFree": {
            "title": "Only free items",
            "type": "boolean",
            "description": "Only emit records that are name-your-price-zero or explicitly free.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "useProxy": {
            "title": "Use Apify proxy",
            "type": "boolean",
            "description": "Route requests through Apify proxy. Bandcamp is normally accessible without a proxy.",
            "editor": "checkbox",
            "default": false,
            "prefill": false,
            "sectionCaption": "Proxy & escalation",
            "sectionDescription": "Optional Apify proxy. Auto-escalation transparently retries through proxy on 403/429."
          },
          "autoEscalateOnBlock": {
            "title": "Auto-escalate to proxy on block",
            "type": "boolean",
            "description": "If direct fetches return 403/429, retry through Apify proxy automatically.",
            "editor": "checkbox",
            "default": true,
            "prefill": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional Apify proxy configuration override.",
            "editor": "proxy",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": []
            },
            "prefill": {
              "useApifyProxy": true,
              "apifyProxyGroups": []
            }
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "editor": "number",
            "minimum": 1,
            "maximum": 1000,
            "default": 50,
            "prefill": 50,
            "sectionCaption": "Output cap"
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Bandcamp Album, Track & Discography Extractor Output",
        "description": "Bandcamp album, track, artist, and label records with tracklists, release dates, pricing, tags, and cover art.",
        "properties": {
          "records": {
            "type": "string",
            "title": "Bandcamp records",
            "description": "Dataset containing all scraped Bandcamp records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Bandcamp records",
              "transformation": {
                "fields": [
                  "recordType",
                  "title",
                  "artistName",
                  "labelName",
                  "releaseDate",
                  "price",
                  "tags",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {},
      "defaultMemoryMbytes": 1024,
      "minMemoryMbytes": 256,
      "maxMemoryMbytes": 4096
    },
    "buildNumber": "1.0.2",
    "imageDigest": "5d464c9956fda88297b0c8dffa3da707b037aa7ac01fc7bc96eb82b6d59b8445",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.01095
    }
  }
}