# Bandcamp Album, Track & Discography Extractor (`dataspryva/bandcamp-album-track-and-discography-extractor`) Actor

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.

- **URL**: https://apify.com/dataspryva/bandcamp-album-track-and-discography-extractor.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Automation, Developer tools, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Bandcamp Album, Track & Discography Extractor

Pull 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.

### What this actor does

- 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
- Searches Bandcamp's own index for albums, tracks, artists/bands, or labels by keyword
- 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
- Browses a tag or top-level genre hub, or the front-page discover feed sorted by top/new/recommended
- Filters results by minimum/maximum price or to only free/name-your-price items before they're returned
- Omits any field that has no value for a given record rather than returning it empty or null

### Output per record

Every record carries `recordType` (`album`, `track`, `artist`, or `label`), a canonical `url`, `scrapedAt`, and `siteName`. What else is present depends on what was fetched:

**Albums**

- `title`, `description`, `credits`, `releaseType`
- `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`
- `coverUrl`, `coverUrlOriginal` — cover artwork
- `numTracks`, `tracks[]` — each with `title`, `trackNumber`, `duration`, `durationSeconds`, `trackId`, `streamUrl`, `lyrics`
- `releaseDate`, `originalReleaseDate`
- `tags[]` — up to 30 Bandcamp tags
- `price`, `minimumPrice`, `currency`, `isFree`
- `upc`, `formats[]` — physical/digital editions with `formatName`, `title`, `price`, `currency`, `upc`, `sku`, `available`
- `hasAudio`, `isPreorder`
- `albumId`, `artId`, `featuredTrackId`, `bandId`

**Tracks**

- `title`, `description`, `artistName`, `artistUrl`, `artistImageUrl`, `labelName`, `labelUrl`
- `albumTitle`, `albumUrl`, `albumId`, `trackNumber`
- `coverUrl`, `coverUrlOriginal`, `duration`, `durationSeconds`, `streamUrl`, `lyrics`
- `releaseDate`, `tags[]`, `price`, `currency`, `trackId`, `isrc`, `credits`, `licenseName`, `bandId`

**Artists / labels**

- `name`, `description`, `location`, `url`, `imageUrl`, `bandId`
- `isLabel`, `currency`, `links[]` — the artist's own linked sites
- `discography[]` — each with `title`, `artist`, `type`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`
- `discographyCount`

**Discography mode (`byDiscography`)**

- One `album` or `track` record per release: `title`, `artistName`, `url`, `coverUrl`, `releaseDate`, `albumId` / `trackId`, `bandId`
- With `enrichDiscography: true`, each record is replaced by the full album/track record above (tracklist, price, tags, audio stream, and so on)

**Search, tag, genre & discover results**

- `title` or `name`, `artistName`, `artistUrl`, `coverUrl`, `imageUrl`
- `albumId` / `trackId` / `bandId`
- `tags[]` — search results only
- `genre`, `location`, `releaseDate`, `artistImageUrl`, `featuredTrack` — present on discover/tag/genre results, with `title`, `trackId`, `durationSeconds`, `streamUrl`
- Tag results from the search fallback also include the `tags[]` that matched the requested tag

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string (select) | `byUrl` | What to fetch: `byUrl`, `searchAlbum`, `searchTrack`, `searchArtist`, `searchBand`, `searchLabel`, `byArtist`, `byDiscography`, `byAlbum`, `byTrack`, `byTag`, `byGenre`, `discover` |
| `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`) |
| `urls` | array | `[]` | Multiple bandcamp.com URLs for a batch `byUrl` run |
| `query` | string | `ambient` | Keyword for the search modes |
| `artistSubdomain` | string | – | Artist subdomain (the part before `.bandcamp.com`), combined with `albumSlug`/`trackSlug` |
| `artistUrl` | string | – | Full artist or label homepage URL (`mode=byArtist`/`byDiscography`) |
| `enrichDiscography` | boolean | `false` | Open each release's album/track page for full details (`mode=byDiscography`); off reads the fast `/music` grid only |
| `albumSlug` | string | – | Album slug, the part after `/album/` (`mode=byAlbum`) |
| `trackSlug` | string | – | Track slug, the part after `/track/` (`mode=byTrack`) |
| `tag` | string | – | Tag slug, e.g. `electronic`, `lo-fi` (`mode=byTag`) |
| `genre` | string (select) | – | Curated top-level genre (`mode=byGenre`/`discover`) |
| `sortBy` | string (select) | `top` | Discover feed order: `top`, `new`, or `rec` (`mode=discover`) |
| `minPrice` | number | – | Drop records priced below this many USD; unpriced records still pass |
| `maxPrice` | number | – | Drop records priced above this many USD; unpriced records still pass |
| `onlyWithAudio` | boolean | `false` | Keep only records with a streamable audio URL or featured track |
| `onlyFree` | boolean | `false` | Keep only free / name-your-price-zero items |
| `useProxy` | boolean | `false` | Route requests through Apify proxy |
| `autoEscalateOnBlock` | boolean | `true` | Automatically retry through proxy if a direct request is blocked |
| `proxyConfiguration` | object | `{"useApifyProxy": true, "apifyProxyGroups": []}` | Optional proxy configuration override |
| `maxItems` | integer | `50` | Hard cap on the number of records returned (1-1000) |

#### Example: fetch a specific album

```json
{
  "mode": "byUrl",
  "url": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven"
}
```

#### Example: list an artist's full discography

```json
{
  "mode": "byDiscography",
  "artistUrl": "https://godspeedyoublackemperor.bandcamp.com/",
  "enrichDiscography": true,
  "maxItems": 50
}
```

#### Example: search for albums by keyword

```json
{
  "mode": "searchAlbum",
  "query": "ambient",
  "maxItems": 30
}
```

#### Example: browse a tag, filtered to free releases

```json
{
  "mode": "byTag",
  "tag": "lo-fi",
  "onlyFree": true,
  "maxItems": 40
}
```

#### Example: discover feed, new electronic releases

```json
{
  "mode": "discover",
  "genre": "electronic",
  "sortBy": "new",
  "maxItems": 25
}
```

### Use cases

- Music blogs and playlisters tracking new releases in a genre or tag
- Labels and artists monitoring how their own catalog appears on Bandcamp
- Fans building a complete, up-to-date list of an artist's discography
- Researchers studying tag/genre trends or pricing patterns across independent music
- Developers building a Bandcamp-backed search or recommendation index
- Crate-diggers filtering releases down to free or pay-what-you-want items

### FAQ

**Do I need a Bandcamp account to use this?**
No. Every mode reads pages and endpoints that Bandcamp already serves publicly.

**Does this actor download the actual audio files?**
No. Track records include `streamUrl`, a link to the short preview stream Bandcamp itself serves; the actor doesn't fetch or store the audio bytes.

**Can it scrape a fan's collection or profile page?**
No — fan profiles sit behind a Bandcamp login and aren't covered by any mode here.

**What's the difference between `byTag` and `byGenre`?**
`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.

**How complete is a discography?**
`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`.

**Why do `price` or `minimumPrice` sometimes not appear?**
Many 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.

**Why is `lyrics` or `duration` missing from some tracks?**
Those 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.

**How current is the data?**
Album, 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.

**Will `minPrice`/`maxPrice` filter out free releases?**
Free 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.

**Is this affiliated with Bandcamp?**
No. This is an independent tool that reads Bandcamp's publicly accessible pages and search results.

# Actor input Schema

## `mode` (type: `string`):

What to fetch. Search, fetch by URL, list an artist/label full discography, browse a tag/genre, or read the discover feed.

## `url` (type: `string`):

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.

## `urls` (type: `array`):

Multiple bandcamp.com URLs. Album/track/artist/tag URLs are auto-routed.

## `query` (type: `string`):

Free-text query for the search modes.

## `artistSubdomain` (type: `string`):

Artist subdomain on bandcamp.com (the part before `.bandcamp.com`). Combine with `albumSlug` or `trackSlug` to build a URL.

## `artistUrl` (type: `string`):

Full URL of an artist or label homepage. byArtist reads the profile; byDiscography lists every release on its /music page.

## `enrichDiscography` (type: `boolean`):

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.

## `albumSlug` (type: `string`):

Album slug — the part after `/album/` in the URL.

## `trackSlug` (type: `string`):

Track slug — the part after `/track/` in the URL.

## `tag` (type: `string`):

Bandcamp tag slug, e.g. `electronic`, `lo-fi`, `synthwave`.

## `genre` (type: `string`):

One of the curated Bandcamp top-level genres. Used by mode=byGenre and mode=discover.

## `sortBy` (type: `string`):

Sort order for the discover feed.

## `minPrice` (type: `number`):

Drop records with a listed price below this value. Records without pricing data pass.

## `maxPrice` (type: `number`):

Drop records with a listed price above this value. Records without pricing data pass.

## `onlyWithAudio` (type: `boolean`):

Only emit records that have a streamable audio URL or featured track.

## `onlyFree` (type: `boolean`):

Only emit records that are name-your-price-zero or explicitly free.

## `useProxy` (type: `boolean`):

Route requests through Apify proxy. Bandcamp is normally accessible without a proxy.

## `autoEscalateOnBlock` (type: `boolean`):

If direct fetches return 403/429, retry through Apify proxy automatically.

## `proxyConfiguration` (type: `object`):

Optional Apify proxy configuration override.

## `maxItems` (type: `integer`):

Hard cap on emitted records.

## Actor input object example

```json
{
  "mode": "byUrl",
  "url": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
  "urls": [],
  "query": "ambient",
  "enrichDiscography": false,
  "sortBy": "top",
  "onlyWithAudio": false,
  "onlyFree": false,
  "useProxy": false,
  "autoEscalateOnBlock": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  },
  "maxItems": 50
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped Bandcamp records.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "byUrl",
    "url": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
    "urls": [],
    "query": "ambient",
    "enrichDiscography": false,
    "sortBy": "top",
    "onlyWithAudio": false,
    "onlyFree": false,
    "useProxy": false,
    "autoEscalateOnBlock": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": []
    },
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/bandcamp-album-track-and-discography-extractor").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "byUrl",
    "url": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
    "urls": [],
    "query": "ambient",
    "enrichDiscography": False,
    "sortBy": "top",
    "onlyWithAudio": False,
    "onlyFree": False,
    "useProxy": False,
    "autoEscalateOnBlock": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": [],
    },
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/bandcamp-album-track-and-discography-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "byUrl",
  "url": "https://godspeedyoublackemperor.bandcamp.com/album/lift-your-skinny-fists-like-antennas-to-heaven",
  "urls": [],
  "query": "ambient",
  "enrichDiscography": false,
  "sortBy": "top",
  "onlyWithAudio": false,
  "onlyFree": false,
  "useProxy": false,
  "autoEscalateOnBlock": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  },
  "maxItems": 50
}' |
apify call dataspryva/bandcamp-album-track-and-discography-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/bandcamp-album-track-and-discography-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ubjt6aJQtdEXl2jpL/builds/d02No4P3NyfVbrlUU/openapi.json
