# Bandcamp API — albums, tracks, merch, prices and stock, artists and labels, Discover, sales feed, fans and Bandcamp Daily

> Bandcamp's own search: artists and labels, albums, tracks and fans matching a name, with links, ids, location, genre and tags. Up to 50 rows per call — the site's search answers 50 per type and has no second page, so narrow with `type`.
> ReefAPI engine `bandcamp` · 23 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/bandcamp/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/bandcamp/v1/search — 1 credit
Bandcamp's own search: artists and labels, albums, tracks and fans matching a name, with links, ids, location, genre and tags. Up to 50 rows per call — the site's search answers 50 per type and has no second page, so narrow with `type`.

**Parameters:**
- `query` (string, required) — Words to look for: an artist, label, album, track or fan name.
- `type` (enum, optional, default "all") — all (default: artists & labels, albums, tracks and fans mixed, as the site's search box), artists (artists AND labels; `is_label` tells them apart), albums, tracks, fans. [one of: all, artists, albums, tracks, fans]

**Returns:** count, rows[]{type (artist|album|track|fan), id, name, url, …artist: is_label, location, genre, tags[], image_url · album/track: artist, band_id, band_url, art_url, album, album_id · fan: username, collection_size, genre, image_url}, matching_tags[]{name, slug, release_count, url}, matching_genre{genre, subgenre}

**Example request body:**
```json
{
  "query": "radiohead"
}
```

### POST https://api.reefapi.com/bandcamp/v1/search_pages — 3 credits
Bandcamp's full search results page by page, as on bandcamp.com/search: 18 rows per page with release date, track count and length, tags, genre and location; type filter (all, artists & labels, albums, tracks, fans). Deeper than `search`: the site lists up to 100 albums or mixed results (6 pages) and up to 500 tracks (28 pages) per query, measured. The first call of an hour can take about 20 seconds.

**Parameters:**
- `query` (string, required) — Words to look for: an artist, label, album, track or fan name.
- `type` (enum, optional, default "all") — all (default: artists & labels, albums, tracks and fans mixed, as the site's search box), artists (artists AND labels; `is_label` tells them apart), albums, tracks, fans. [one of: all, artists, albums, tracks, fans]
- `page` (integer, optional, default 1) — Result page, 1-based (18 rows per page; the site stops at page 6 for albums / mixed results and page 28 for tracks).

**Returns:** query, type, page, per_page (18), has_more, last_page_listed, rows[]{type (album|track|artist|fan), printed_type (album|track|artist|label|fan), id, name, url, image_url, artist, album (tracks), track_count, length_minutes, release_date, is_label, location, genre, tags[]}

**Example request body:**
```json
{
  "query": "radiohead"
}
```

### POST https://api.reefapi.com/bandcamp/v1/album — 1 credit
Everything on an album page: digital price (minimum, 'or more', name-your-price, free download), every physical format (vinyl, CD, cassette, shirts…) with price, currency, units left, sold-out flag, edition size, size options and ship date, full track list with durations and lyrics, release date, tags, about and credits, label, seller, the 'supported by' fans and fan reviews shown on the page, and upcoming shows.

**Parameters:**
- `url` (string, required) — The release's page link: `https://<artist>.bandcamp.com/album/<slug>` (or /track/, /merch/; an artist's own domain works too).

**Returns:** type (album|track|merch), id, url, title, artist, band{id, name, url, location, bio, links[], image_url}, label{name, url}, seller{id, name, currency, is_dsa_trader, is_stripe_seller}, release_date, published, modified, is_preorder, about, credits, license, tags[]{name, url}, upc, isrc, catalog_number, art_url, track_count, duration_sec, digital{price, currency, name_your_price, or_more, set_price, free_download, purchasable, price_label}, packages[]{id, title, type, type_id, format, price, currency, or_more, availability, sold_out, quantity_available, quantity_sold, edition_size, max_per_order, options_title, options[]{id, title, sku, quantity_available, sold_out}, includes_digital, ships_on, fulfillment_days, description, sku, upc, images[], is_live_ticket, subscriber_only, certified_seller, url}, full_discography_offer{id, title, price, currency, url}, tracks[]{number, id, title, artist, duration_sec, url, has_lyrics, lyrics, streamable, downloadable, unreleased, has_video}, supporters[]{fan_id, username, name, url, image_url, cursor}, more_supporters, reviews[]{fan_id, username, name, url, image_url, text, favorite_track, cursor}, more_reviews, upcoming_shows[]{date, venue, location, url}, embeddable; track pages add album{title, url}, track_number, license_name, lyrics

**Example request body:**
```json
{
  "url": "https://radiohead.bandcamp.com/album/in-rainbows"
}
```

### POST https://api.reefapi.com/bandcamp/v1/track — 1 credit
Everything on a track page: price, ISRC, duration, lyrics, album link, tags, credits, physical formats of its album, supporters and reviews.

**Parameters:**
- `url` (string, required) — The track link `https://<artist>.bandcamp.com/track/<slug>`.

**Returns:** type (album|track|merch), id, url, title, artist, band{id, name, url, location, bio, links[], image_url}, label{name, url}, seller{id, name, currency, is_dsa_trader, is_stripe_seller}, release_date, published, modified, is_preorder, about, credits, license, tags[]{name, url}, upc, isrc, catalog_number, art_url, track_count, duration_sec, digital{price, currency, name_your_price, or_more, set_price, free_download, purchasable, price_label}, packages[]{id, title, type, type_id, format, price, currency, or_more, availability, sold_out, quantity_available, quantity_sold, edition_size, max_per_order, options_title, options[]{id, title, sku, quantity_available, sold_out}, includes_digital, ships_on, fulfillment_days, description, sku, upc, images[], is_live_ticket, subscriber_only, certified_seller, url}, full_discography_offer{id, title, price, currency, url}, tracks[]{number, id, title, artist, duration_sec, url, has_lyrics, lyrics, streamable, downloadable, unreleased, has_video}, supporters[]{fan_id, username, name, url, image_url, cursor}, more_supporters, reviews[]{fan_id, username, name, url, image_url, text, favorite_track, cursor}, more_reviews, upcoming_shows[]{date, venue, location, url}, embeddable; track pages add album{title, url}, track_number, license_name, lyrics

**Example request body:**
```json
{
  "url": "https://radiohead.bandcamp.com/album/in-rainbows"
}
```

### POST https://api.reefapi.com/bandcamp/v1/merch_item — 1 credit
One merch item page (shirt, poster, bundle, vinyl-only…): price, currency, units left, sold-out flag, size / colour options with their own stock, description, images, seller.

**Parameters:**
- `url` (string, required) — The merch link `https://<artist>.bandcamp.com/merch/<slug>`.

**Returns:** type (album|track|merch), id, url, title, artist, band{id, name, url, location, bio, links[], image_url}, label{name, url}, seller{id, name, currency, is_dsa_trader, is_stripe_seller}, release_date, published, modified, is_preorder, about, credits, license, tags[]{name, url}, upc, isrc, catalog_number, art_url, track_count, duration_sec, digital{price, currency, name_your_price, or_more, set_price, free_download, purchasable, price_label}, packages[]{id, title, type, type_id, format, price, currency, or_more, availability, sold_out, quantity_available, quantity_sold, edition_size, max_per_order, options_title, options[]{id, title, sku, quantity_available, sold_out}, includes_digital, ships_on, fulfillment_days, description, sku, upc, images[], is_live_ticket, subscriber_only, certified_seller, url}, full_discography_offer{id, title, price, currency, url}, tracks[]{number, id, title, artist, duration_sec, url, has_lyrics, lyrics, streamable, downloadable, unreleased, has_video}, supporters[]{fan_id, username, name, url, image_url, cursor}, more_supporters, reviews[]{fan_id, username, name, url, image_url, text, favorite_track, cursor}, more_reviews, upcoming_shows[]{date, venue, location, url}, embeddable; track pages add album{title, url}, track_number, license_name, lyrics

**Example request body:**
```json
{
  "url": "https://radiohead.bandcamp.com/album/in-rainbows"
}
```

### POST https://api.reefapi.com/bandcamp/v1/album_supporters — 2 credits
Every fan in an album's or track's 'supported by' list (username, display name, profile link, picture), newest first, with cursor paging to the end of the list.

**Parameters:**
- `item_id` (string, optional) — The album or track id (the `id` of an `album` / `track` / `search` / `discover` row). Or give `url` instead.
- `item_type` (enum, optional, default "album") — album (default) or track — what `item_id` is. [one of: album, track]
- `url` (string, optional) — Instead of `item_id`: the album or track link (costs one extra page read to find the id).
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 40) — Fans per page, 1-100 (default 40).

**Returns:** item{id, type}, rows[]{fan_id, username, name, url, image_url, date, cursor}, has_more, next_cursor

**Example request body:**
```json
{
  "item_id": 2162872411
}
```

### POST https://api.reefapi.com/bandcamp/v1/album_reviews — 2 credits
Every fan review written on an album or track (the 'supported by' quotes): text, favourite track, reviewer's name and profile, with cursor paging.

**Parameters:**
- `item_id` (string, optional) — The album or track id (the `id` of an `album` / `track` / `search` / `discover` row). Or give `url` instead.
- `item_type` (enum, optional, default "album") — album (default) or track — what `item_id` is. [one of: album, track]
- `url` (string, optional) — Instead of `item_id`: the album or track link (costs one extra page read to find the id).
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 40) — Reviews per page, 1-100 (default 40).

**Returns:** item{id, type}, rows[]{fan_id, username, name, url, image_url, text, favorite_track, date, cursor}, has_more, next_cursor

**Example request body:**
```json
{
  "item_id": 2162872411
}
```

### POST https://api.reefapi.com/bandcamp/v1/artist — 2 credits
An artist's or label's profile: name, location, bio, links, photo, the WHOLE discography (id, title, type, release date, art, link), a label's artist roster, the merch list with stock flags, and upcoming shows.

**Parameters:**
- `band` (string, required) — The artist or label: its page link (`https://hyperdub.bandcamp.com`), its subdomain (`hyperdub`) or its numeric band id (the `id` of an artist row in `search`).

**Returns:** id, name, url, is_label, location, bio, image_url, header_image_url, sites[]{url, title}, navbar[], currency, created, discography_count, discography[]{id, type, title, artist, band_id, release_date, purchasable, art_url, url}, artists_count, artists[]{id, name, location, image_url, featured}, merch_count, merch[]{id, title, type, type_id, artist, band_id, in_stock, release{id, type, title}, images[], is_live_ticket}, upcoming_shows[]{date, venue, location, url}

**Example request body:**
```json
{
  "band": "hyperdub"
}
```

### POST https://api.reefapi.com/bandcamp/v1/artist_merch — 1 credit
An artist's or label's whole merch shop with each item's price, currency, type and sold-out flag (the shop page lists every item at once; no paging).

**Parameters:**
- `band` (string, required) — The artist or label: its page link (`https://hyperdub.bandcamp.com`), its subdomain (`hyperdub`) or its numeric band id (the `id` of an artist row in `search`).

**Returns:** band{id, name, url}, count, sold_out_count, rows[]{id, band_id, title, artist, type, price, currency, price_text, sold_out, url, image_url}

**Example request body:**
```json
{
  "band": "hyperdub"
}
```

### POST https://api.reefapi.com/bandcamp/v1/discover — 1 credit
Bandcamp Discover with every filter the site has: genre, sub-genre, any tags, format (digital, vinyl, CD, cassette, t-shirt), artist location, best-selling / new arrivals / random, time window; price, currency, release date, track count, physical formats with prices per row; real cursor paging (`total` is the site's own count).

**Parameters:**
- `genre` (string, optional) — One of the site's 26 genres (`electronic`, `rock`, `metal`, `hip-hop-rap`, `ambient`, `jazz`, `r-b-soul` … — `discover_options` lists them). Omit for all genres.
- `subgenre` (string, optional) — A sub-genre of `genre`, from the site's list (`house`, `techno`, `drone` … — `discover_options`).
- `tags` (array, optional) — Any Bandcamp tags (`vaporwave`, `berlin`, `field-recordings`); several = releases carrying ALL of them, combined with genre / subgenre.
- `format` (enum, optional, default "all") — all (default), digital, vinyl, cd, cassette, tshirt. [one of: all, digital, vinyl, cd, cassette, tshirt]
- `location` (string, optional) — Where the artist is: a place name (`London`, `Berlin`, `Tokyo` — the site's best match is used, see `meta.location`) or a GeoNames id (`2643743`). Omit for anywhere.
- `sort` (enum, optional, default "top") — top = best-selling (default), new = new arrivals, rand = surprise me. [one of: top, new, rand]
- `time` (string, optional) — Time window: today, this_week, last_week, 2_weeks_ago … 6_weeks_ago (or 0-7, the site's own ids). Omit for any time.
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 60) — Releases per page, 1-60 (default 60).

**Returns:** total, per_page, has_more, next_cursor, rows[]{type (album|merch), id, title, url, artist, band{id, name, url, location, image_url}, genre_id, genre, price, currency, name_your_price, or_more, free_download, is_preorder, release_date, track_count, duration_sec, art_url, extra_images[], packages[]{id, title, format, type_id, price, currency, or_more, includes_digital, is_preorder, image_url}, featured_track{id, title, url, duration_sec, price, currency}}, applied{}

**Example request body:**
```json
{
  "genre": "electronic"
}
```

### POST https://api.reefapi.com/bandcamp/v1/discover_options — 0 credits
The values `discover` accepts: the site's 26 genres with their sub-genres, the formats, sorts and time windows (no call to the site).

**Parameters:** none

**Returns:** genres[]{slug, name, id, subgenres[]}, formats[]{value, label}, sorts[]{value, label}, times[]{value, id, label}

### POST https://api.reefapi.com/bandcamp/v1/locations — 1 credit
The site's own place lookup for Discover's location filter: matching cities / regions with their GeoNames ids.

**Parameters:**
- `query` (string, required) — A place name (`london`, `berlin`).
- `limit` (integer, optional, default 10) — How many, 1-20 (default 10).

**Returns:** count, rows[]{id (GeoNames), name, full_name}

**Example request body:**
```json
{
  "query": "radiohead"
}
```

### POST https://api.reefapi.com/bandcamp/v1/related_tags — 1 credit
Tags related to one or more Bandcamp tags, with the site's relation score (0-1).

**Parameters:**
- `tags` (array, required) — One or more tags (`ambient`, `vaporwave`); each gets its own related list.
- `limit` (integer, optional, default 30) — Related tags per tag, 1-100 (default 30).

**Returns:** results[]{tag{name, slug, url}, related[]{id, name, slug, relation, is_location, url}}

**Example request body:**
```json
{
  "tags": "ambient"
}
```

### POST https://api.reefapi.com/bandcamp/v1/sales_feed — 1 credit
Bandcamp's live global sales feed: every sale in the last minutes — what sold (album, track, merch, bundle), artist, price paid and currency, USD equivalent, buyer's country, link. The site publishes a rolling 10-minute window with a 2-minute delay.

**Parameters:**
- `since` (integer, optional) — Unix seconds: only sales after this moment (inside the site's last-10-minutes window; pass the previous call's `window_end_ts` to follow the feed).

**Returns:** window_start, window_end, window_start_ts, window_end_ts, data_delay_sec, count, rows[]{event, sold_at, type, item, album, artist, amount_paid, item_price, currency, amount_paid_usd, amount_paid_text, buyer_country, buyer_country_code, url, art_url, bundle_releases}

### POST https://api.reefapi.com/bandcamp/v1/fan — 1 credit
A fan's public profile: name, bio, location, website, picture, favourite genre, counts (collection, wishlist, followers, following), the first page of the collection and wishlist, the artists, fans and genres they follow, and their followers.

**Parameters:**
- `fan` (string, required) — The fan: username (`ambient_`), profile link (`https://bandcamp.com/ambient_`) or numeric fan id (the `id` of a fan row in `search`).

**Returns:** id, username, name, url, location, bio, website, image_url, favorite_genre, counts{collection, wishlist, followers, following_artists, following_fans, following_genres, subscriptions}, wishlist_hidden, collection{total, rows[], has_more, next_cursor}, wishlist{…}, following_artists{total, rows[]}, followers{total, rows[]}, following_genres{total, rows[]}

**Example request body:**
```json
{
  "fan": "ambient_"
}
```

### POST https://api.reefapi.com/bandcamp/v1/fan_collection — 1 credit
Every album and track in a fan's public collection, newest purchase first: title, artist, link, label, price and currency, purchase date, the fan's note, with cursor paging.

**Parameters:**
- `fan` (string, required) — The fan: username (`ambient_`), profile link (`https://bandcamp.com/ambient_`) or numeric fan id (the `id` of a fan row in `search`).
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 20) — Items per page, 1-50 (default 20).

**Returns:** fan{id, username}, rows[]{id, type, title, url, artist, band_id, band_url, album{id, title}, label, label_id, art_url, price, currency, or_more, is_preorder, purchasable, merch_sold_out, added, purchased, fan_note, featured_track{id, title, number, duration_sec}, also_collected_count, genre_id, genre, cursor}, has_more, next_cursor

**Example request body:**
```json
{
  "fan": "ambient_"
}
```

### POST https://api.reefapi.com/bandcamp/v1/fan_wishlist — 1 credit
A fan's public wishlist, same fields and paging as `fan_collection`.

**Parameters:**
- `fan` (string, required) — The fan: username (`ambient_`), profile link (`https://bandcamp.com/ambient_`) or numeric fan id (the `id` of a fan row in `search`).
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 20) — Items per page, 1-50 (default 20).

**Returns:** fan{id, username}, rows[]{…as fan_collection}, has_more, next_cursor

**Example request body:**
```json
{
  "fan": "ambient_"
}
```

### POST https://api.reefapi.com/bandcamp/v1/fan_following — 1 credit
Who and what a fan follows: artists & labels, other fans, or genres; with cursor paging. The site's genre list leaves out the fan's favourite genre (measured on 3 of 3 fans); `fan` returns it as `favorite_genre` and in its full `following_genres`.

**Parameters:**
- `fan` (string, required) — The fan: username (`ambient_`), profile link (`https://bandcamp.com/ambient_`) or numeric fan id (the `id` of a fan row in `search`).
- `kind` (enum, optional, default "artists") — artists (default — artists and labels), fans, genres. [one of: artists, fans, genres]
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 40) — Rows per page, 1-100 (default 40).

**Returns:** fan{id, username}, kind, rows[]{type (artist|fan|genre), id, name, url, location, image_url, followed, cursor; genre rows: slug, genre_id, format}, has_more, next_cursor

**Example request body:**
```json
{
  "fan": "ambient_"
}
```

### POST https://api.reefapi.com/bandcamp/v1/fan_followers — 1 credit
The fans who follow a fan, with cursor paging.

**Parameters:**
- `fan` (string, required) — The fan: username (`ambient_`), profile link (`https://bandcamp.com/ambient_`) or numeric fan id (the `id` of a fan row in `search`).
- `cursor` (string, optional) — `next_cursor` from the previous page; omit for the first page.
- `per_page` (integer, optional, default 40) — Fans per page, 1-100 (default 40).

**Returns:** fan{id, username}, rows[]{type, id, name, url, location, image_url, followed, cursor}, has_more, next_cursor

**Example request body:**
```json
{
  "fan": "ambient_"
}
```

### POST https://api.reefapi.com/bandcamp/v1/daily_articles — 1 credit
Bandcamp Daily article lists, newest first: all (`latest`) or one series (album-of-the-day, essential-releases, best-ambient, best-jazz, lists, features, label-profile, scene-report …), 30 per page with the site's total.

**Parameters:**
- `category` (string, optional, default "latest") — `latest` (default, every article) or a series slug as in the site's menu: album-of-the-day, essential-releases, features, lists, best-ambient, best-electronic, best-hip-hop, best-jazz, best-metal, best-punk, best-soul, label-profile, scene-report, big-ups, hidden-gems, high-scores …
- `page` (integer, optional, default 1) — Page, 1-based (30 articles each).

**Returns:** category, page, per_page (30), total, first, last, has_more, rows[]{title, url, category, category_slug, date, date_text, is_album_of_the_day, image_url}

**Example request body:**
```json
{
  "category": "album-of-the-day"
}
```

### POST https://api.reefapi.com/bandcamp/v1/daily_article — 1 credit
One Bandcamp Daily article: title, series, author, dates, summary, genre, the full text by paragraph, and every release it features (title, artist, link, label, track list).

**Parameters:**
- `url` (string, required) — The article link `https://daily.bandcamp.com/<series>/<slug>`.

**Returns:** url, title, category, author{name, url}, published, modified, description, genre, image_url, paragraphs[], text, releases[]{key, title, artist, url, band_url, label, art_url, price, currency, tracks[]{id, title, artist, duration_sec, number}}

**Example request body:**
```json
{
  "url": "https://radiohead.bandcamp.com/album/in-rainbows"
}
```

### POST https://api.reefapi.com/bandcamp/v1/weekly_shows — 1 credit
The Bandcamp Weekly radio-show archive, newest first (every episode the site lists).

**Parameters:**
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Shows per page, 1-100 (default 20).

**Returns:** total, page, per_page, has_more, rows[]{id, title, subtitle, date, published, description, caption, image_url, url}

### POST https://api.reefapi.com/bandcamp/v1/weekly_show — 1 credit
One Bandcamp Weekly episode with its whole track list (artist, title, link, label, price, start time in the show).

**Parameters:**
- `show_id` (integer, required) — The episode id (`id` of a `weekly_shows` row).

**Returns:** id, title, subtitle, date, published, description, short_description, caption, image_url, url, duration_sec, audio_title, tracks[]{id, title, artist, url, album, album_id, band_id, location, label, price, currency, or_more, purchasable, is_preorder, starts_at_sec, art_url}

**Example request body:**
```json
{
  "show_id": 1027
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=bandcamp
- Human docs page: https://reefapi.com/docs/bandcamp
- Overview page: https://reefapi.com/bandcamp-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
