# Bandcamp New Release Scraper (`jungle_synthesizer/bandcamp-discover-new-release-scraper`) Actor Scrapes the Bandcamp Discover feed for new releases. Filter by genre tag and sort order. Returns title, artist, label, genre tags, release date, price, and Bandcamp URL. Ideal for music supervisors, sync agents, and A\&R researchers tracking indie new releases. - **URL**: https://apify.com/jungle\_synthesizer/bandcamp-discover-new-release-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** For creators, Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 New Release Scraper Scrapes the Bandcamp Discover feed for new album and track releases. Filter by genre tag and sort order to track new music in any genre — from electronic and jazz to hip-hop and metal. ### What it does Calls the Bandcamp internal discover API to retrieve a rolling feed of new releases. Each result includes the album title, artist name, genre tag, release date, price, track count, artist location, featured track title, and direct Bandcamp URL. The actor paginates through the cursor-based feed until it reaches your `maxItems` limit. Data is returned with no audio content — metadata only, with a clean legal posture. ### Use cases - **Music supervisors and sync agents** tracking new indie releases in specific genres - **Music blogs and newsletters** building "new releases this week" roundups - **A&R research** monitoring emerging artists on Bandcamp - **Price and release monitoring** for music labels and distributors - **Recurring weekly/daily feeds** for any genre or global filter ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `maxItems` | integer | 60 | Maximum number of releases to scrape | | `genreTag` | string | (all) | Genre/tag slug to filter (e.g. `electronic`, `hip-hop-rap`, `jazz`) | | `sortOrder` | string | `new` | Sort order: `new` (newest), `top` (top releases), `rec` (recommended) | #### Genre tag examples Use the normalized Bandcamp genre slug as the `genreTag` value: `electronic`, `rock`, `metal`, `alternative`, `hip-hop-rap`, `experimental`, `folk`, `pop`, `punk`, `ambient`, `soundtrack`, `world`, `jazz`, `latin`, `lo-fi`, `blues`, `classical`, `country`, `funk`, `r-b-soul`, `reggae`, `spoken-word` #### Example input ```json { "maxItems": 60, "genreTag": "electronic", "sortOrder": "new" } ```` Leave `genreTag` empty to browse all genres on the main discover feed. ### Output Each result is a flat JSON object: ```json { "album_id": 1648818688, "title": "Atheosis", "artist": "Atheosis", "label": null, "genre_tag": "metal", "secondary_tags": null, "release_date": "2026-05-22", "price": 3.0, "currency": "GBP", "is_name_your_price": false, "track_count": 3, "location": "Brighton And Hove, UK", "featured_track": "Pale Emanation", "bandcamp_url": "https://atheosis1.bandcamp.com/album/atheosis", "artwork_url": "https://f4.bcbits.com/img/a2430942940_10.jpg" } ``` #### Field reference | Field | Type | Description | |-------|------|-------------| | `album_id` | integer | Bandcamp internal album ID | | `title` | string | Album or release title | | `artist` | string | Artist name | | `label` | string | Record label name (null — not returned by the discover API) | | `genre_tag` | string | Primary genre slug (from filter input or genre ID lookup) | | `secondary_tags` | string | Secondary tags (null — not returned by the discover API) | | `release_date` | string | Release date (YYYY-MM-DD) | | `price` | number | Price in the listed currency (0 = free or name-your-price) | | `currency` | string | Three-letter ISO 4217 currency code (e.g. `USD`, `GBP`) | | `is_name_your_price` | boolean | Whether the release uses name-your-price pricing | | `track_count` | integer | Number of tracks on the release | | `location` | string | Artist-declared location (city, country, or region) | | `featured_track` | string | Featured/preview track title | | `bandcamp_url` | string | Full Bandcamp URL to the release page | | `artwork_url` | string | URL to the album artwork thumbnail (350×350 JPG) | ### How it works The actor calls the Bandcamp internal discover API (`POST /api/discover/1/discover_web`) using impit, which spoofs a Chrome TLS fingerprint to bypass Fastly's bot protection. Results are paginated via the API's cursor-based pagination until `maxItems` is reached. No audio content is accessed or downloaded. No artist subdomains are crawled. ### Notes - The Bandcamp discover feed only surfaces albums and releases, not individual tracks - `label` and `secondary_tags` fields are always null — the discover API does not include these in its response - Price amounts are in the currency listed in the `currency` field (not normalized to USD) - The `is_name_your_price` flag is derived from the combination of `price.amount = 0`, `is_set_price = false`, and `is_free_download = false` # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `maxItems` (type: `integer`): Maximum number of releases to scrape. Defaults to 60 (one full page). ## `genreTag` (type: `string`): Genre or tag to filter releases (e.g. "electronic", "hip-hop", "jazz"). Leave blank to browse all genres on the main discover feed. ## `sortOrder` (type: `string`): Sort order for results. "new" = newest first (default). "top" = top releases. "rec" = recommended. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "sortOrder": "new" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "genreTag": "", "sortOrder": "new" }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/bandcamp-discover-new-release-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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "genreTag": "", "sortOrder": "new", } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/bandcamp-discover-new-release-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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "genreTag": "", "sortOrder": "new" }' | apify call jungle_synthesizer/bandcamp-discover-new-release-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/bandcamp-discover-new-release-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bandcamp New Release Scraper", "description": "Scrapes the Bandcamp Discover feed for new releases. Filter by genre tag and sort order. Returns title, artist, label, genre tags, release date, price, and Bandcamp URL. Ideal for music supervisors, sync agents, and A&R researchers tracking indie new releases.", "version": "0.1", "x-build-id": "n9Ee9N1Fz6K2BX08r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~bandcamp-discover-new-release-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-bandcamp-discover-new-release-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/jungle_synthesizer~bandcamp-discover-new-release-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-bandcamp-discover-new-release-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/jungle_synthesizer~bandcamp-discover-new-release-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-bandcamp-discover-new-release-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", "required": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of releases to scrape. Defaults to 60 (one full page).", "default": 60 }, "genreTag": { "title": "Genre / Tag", "type": "string", "description": "Genre or tag to filter releases (e.g. \"electronic\", \"hip-hop\", \"jazz\"). Leave blank to browse all genres on the main discover feed.\n" }, "sortOrder": { "title": "Sort Order", "enum": [ "new", "top", "rec" ], "type": "string", "description": "Sort order for results. \"new\" = newest first (default). \"top\" = top releases. \"rec\" = recommended.\n", "default": "new" } } }, "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 } } } } } } } } } } ```