# Bandcamp Artist & Label Discography Scraper (`hereditary_model/bandcamp-discography-scraper`) Actor

Scrapes complete discographies from Bandcamp artist and label pages: releases, track lists, durations, tags, release dates, and pricing. Pay per release scraped.

- **URL**: https://apify.com/hereditary\_model/bandcamp-discography-scraper.md
- **Developed by:** [Aaron Marxsen](https://apify.com/hereditary_model) (community)
- **Categories:** Automation, Developer tools, Social media
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 results

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Scraper for Artists and Labels

Get the complete discography of any Bandcamp artist or label as structured data: every release with its track list, durations, tags, release date, and cover art. Point it at an artist or label page and get a clean dataset back. Built for DJs digging for music, labels tracking their roster and competitors, music journalists, and data teams building music databases.

### Features

- Scrape a full Bandcamp discography from any artist or label page
- Get every release with title, artist, label, and release date
- Get complete track lists with positions and durations
- Get genre and style tags for every release
- Works with artist pages, label pages, and direct album or track URLs
- Run on a schedule to catch new releases from favorite labels
- Pay per result, no subscription

### Use cases

- Crate digging: dump a label's whole catalog and filter by tag
- New release radar: schedule a daily run and diff the results
- Market research: analyze release cadence and genres across labels
- Build or enrich a music metadata database

### Input

| Field | Type | Description |
| --- | --- | --- |
| `startUrls` | array (required) | Bandcamp artist or label URLs (or direct album/track URLs) |
| `maxReleasesPerArtist` | integer (default 100) | Max releases per artist or label |

```json
{ "startUrls": [{ "url": "https://kompakt.bandcamp.com" }], "maxReleasesPerArtist": 100 }
```

### Output

One dataset item per release:

```json
{
  "url": "https://kompakt-gas.bandcamp.com/album/november-89",
  "type": "album",
  "title": "November 89",
  "artist": "GAS",
  "label": "Kompakt",
  "releaseDate": "07 Nov 2025 00:00:00 GMT",
  "tags": ["Electronic", "Ambient", "Techno"],
  "numTracks": 6,
  "tracks": [{ "position": 1, "title": "November 89 (Continuous Mix)", "durationSeconds": 3167 }]
}
```

### Pricing: worked example

Pay per result. You are charged per release returned in the dataset.

Scraping a 200 release label catalog returns 200 results. See the live listing for the current per result price and total.

### How to use

1. Open the actor and click Try for free.
2. Paste a Bandcamp artist or label URL.
3. Set `maxReleasesPerArtist` to bound the run.
4. Click Start.
5. Download the discography as JSON, CSV, or Excel from the Storage tab.
6. Automate delivery to Google Sheets or Slack with Apify integrations.

### FAQ

**How do I scrape a Bandcamp discography?**
Paste an artist or label URL and the actor reads the public discography, returning one structured record per release with track lists and tags.

**Does it download audio?**
No. It reads public release pages and returns metadata only.

**Can it scrape a whole label roster?**
Yes. Label pages list the releases on the label's public discography, and the actor follows them.

**What data do I get per release?**
Title, artist, label, release date, tags, cover art, and the full track list with durations.

**Can an AI agent run this?**
Yes. It supports agentic payments, so an agent can pull a discography and pay per result.

### API and agents

Run it from the [Apify API](https://docs.apify.com/api/v2) or let an AI agent call it. Supports agentic payments via x402 and Skyfire (pay per event, limited permissions, no Standby).

```bash
curl -X POST "https://api.apify.com/v2/acts/hereditary_model~bandcamp-discography-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "startUrls": [{ "url": "https://kompakt.bandcamp.com" }] }'
```

### Related actors

- [Website to Markdown for RAG and LLMs](https://apify.com/hereditary_model/website-to-markdown)
- [Domain Intelligence API](https://apify.com/hereditary_model/domain-intelligence)
- [Email and Social Media Extractor](https://apify.com/hereditary_model/contact-details-extractor)
- [Local SEO Audit](https://apify.com/hereditary_model/local-seo-audit)
- [Broken Link Checker](https://apify.com/hereditary_model/broken-link-checker)
- [ATS Job Postings Scraper](https://apify.com/hereditary_model/ats-job-postings-scraper)
- [NPI Healthcare Provider Directory](https://apify.com/hereditary_model/healthcare-provider-directory)

# Actor input Schema

## `startUrls` (type: `array`):

Bandcamp artist or label URLs (e.g. https://kompakt.bandcamp.com). Direct album/track URLs also work.

## `maxReleasesPerArtist` (type: `integer`):

Maximum number of releases to scrape per artist or label page. Each scraped release is one billable event.

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

Proxy settings used for scraping. Defaults to no proxy.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://kompakt.bandcamp.com"
    }
  ],
  "maxReleasesPerArtist": 100
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://kompakt.bandcamp.com"
        }
    ]
};

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

# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://kompakt.bandcamp.com" }] }

# Run the Actor and wait for it to finish
run = client.actor("hereditary_model/bandcamp-discography-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": [
    {
      "url": "https://kompakt.bandcamp.com"
    }
  ]
}' |
apify call hereditary_model/bandcamp-discography-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hereditary_model/bandcamp-discography-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/uwlNBPJE6UH0xng8V/builds/SOeZUO5BJhBvPlqny/openapi.json