Bandcamp API & Scraper
This API reads Bandcamp as JSON, logged out, the way a visitor sees it.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`album` returns one album page: the digital price exactly as the page prints it ("$1 USD or more", "£1,000 GBP", "name your price"), the minimum and the artist's set price, every physical format (vinyl, CD, cassette, shirt, box set) with its price, currency, units left, sold-out flag, edition size, size options and ship date, the full track list with durations and lyrics, release date, tags, about text, credits, UPC, label, the selling account, the 'supported by' fans and the fan reviews shown on the page. `track` and `merch_item` read track and merch pages the same way. `artist` returns an artist's or label's profile with the whole discography (Hyperdub: 226 releases, each with release date and link), a label's roster (48 artists) and the merch list; `artist_merch` adds each merch item's price and sold-out flag. `discover` is Bandcamp Discover with every filter the site has: genre, sub-genre, any tag, format, artist location, best-selling, new arrivals or random, and a time window, with cursor paging and the site's own total. `search` returns Bandcamp's quick search (50 rows per type) and `search_pages` the full search results page by page. `sales_feed` is the live global feed of sales with price paid and buyer country. Fan profiles, collections, wishlists and follows, every supporter and review of a release, related tags, Bandcamp Daily articles and the Bandcamp Weekly show archive complete it.
What a Bandcamp field actually contains
Fields that read differently from how they look. Every row was measured against live Bandcamp pages on 2026-11-16.
| Field | What it holds |
|---|---|
| digital.price | The price the page prints on the Buy Digital Album button. When the album is fixed price that is the artist's set price; otherwise it is the minimum and `or_more` is true. Matched the page's own words on 16 of 16 albums ("$1 USD or more", "£9.99 GBP or more", "$999 USD"), JPY included (¥1,235). |
| digital.name_your_price | True when the page says "name your price" (minimum 0). |
| digital.minimum_price, digital.set_price | Both as the source stores them. On a fixed-price album they differ from the printed price: villusrecords "Apiary" has minimum 9, set price 999, and the page prints "$999 USD". |
| packages[].quantity_available | Units left as the seller tracks them; null when the seller does not track stock. When the page prints "N remaining" it was the same number on 4 of 4 packages. |
| packages[].sold_out | True when the page prints Sold Out for that format. Matched on 57 of 57 packages across 18 albums. Sold-out formats print no price on the page; the price is still returned. |
| packages[].options | Size or colour choices with their own stock: a shirt can be sold out in Large and XL with 2 left in XXL. |
| price (discover rows) | Digital price of the row in the release's own currency. Equal to the album page's price on 18 of 18 rows checked. |
| seller | The Bandcamp account that sells the release: the artist, or the label for a label-sold release (In Rainbows: XL Recordings UK), with its currency and EU trader flag. |
| supporters, reviews | The fans shown on the page (up to 80 supporters, up to 6 reviews). `album_supporters` and `album_reviews` page through all of them: 800 supporters in 8 pages without a repeat, 42 reviews for In Rainbows. |
| sales_feed rows | One row per item sold in the last 10 minutes the site publishes (2-minute delay): what sold, artist, amount paid, its currency and US-dollar value, buyer's country. |
Prices are in the currency the seller sells in, not converted. No audio stream or download link is returned.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/bandcamp/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "radiohead"
}
}{
"ok": true,
"meta": {
"api": "bandcamp",
"endpoint": "search",
"mode": "live",
"latency_ms": 958.8,
"record_count": 50,
"bytes": 24914,
"cache_hit": false,
"result_cap": 50,
"upstream_requests": 1,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "2a5b7b553e024ce3",
"fetched_at": "2026-11-16T21:05:21.928Z"
},
"data": {
"count": 50,
"rows": [
{
"type": "artist",
"id": 3957198221,
"name": "Radiohead",
"is_label": false,
"url": "https://radiohead.bandcamp.com",
"location": "Oxford, UK",
"genre": "Alternative",
"tags": [
"Alternative"
],
"image_url": "https://f4.bcbits.com/img/0047220904_10.jpg"
},
{
"type": "album",
"id": 3317386587,
"name": "KID A MNESIA",
"url": "https://radiohead.bandcamp.com/album/kid-a-mnesia",
"artist": "Radiohead",
"band_id": 3957198221,
"band_url": "https://radiohead.bandcamp.com",
"art_url": "https://f4.bcbits.com/img/a3185643660_10.jpg",
"tags": []
},
{
"type": "album",
"id": 2162872411,
"name": "In Rainbows",
"url": "https://radiohead.bandcamp.com/album/in-rainbows",
"artist": "Radiohead",
"band_id": 3957198221,
"band_url": "https://radiohead.bandcamp.com",
"art_url": "https://f4.bcbits.com/img/a0552435637_10.jpg",
"tags": []
}
],
"matching_tags": [
{
"name": "RadioHead",
"slug": "radiohead",
"release_count": 8,
"url": "https://bandcamp.com/discover/radiohead"
}
],
"matching_genre": null,
"type": "all",
"has_more": false
}
}What the Bandcamp API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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`. | Content platforms call search to get bandcamp's own search. | query, type |
| search_pages | 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. | Research tools call search_pages to get bandcamp's full search results page by page, as on bandcamp.com/search. | query, type, page |
| album | 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. | Community analysts call album to get everything on an album page. | url |
| track | Everything on a track page: price, ISRC, duration, lyrics, album link, tags, credits, physical formats of its album, supporters and reviews. | Media monitors call track to get everything on a track page. | url |
| merch_item | 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. | Content platforms call merch_item to get one merch item page (shirt, poster, bundle, vinyl-only…). | url |
| album_supporters | 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. | Research tools call album_supporters to get every fan in an album's or track's 'supported by' list (username, display name, profile link,…. | item_id, item_type, url, cursor, per_page |
| album_reviews | Every fan review written on an album or track (the 'supported by' quotes): text, favourite track, reviewer's name and profile, with cursor paging. | Community analysts call album_reviews to get every fan review written on an album or track (the 'supported by' quotes). | item_id, item_type, url, cursor, per_page |
| artist | 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. | Media monitors call artist to get an artist's or label's profile. | band |
| artist_merch | 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). | Content platforms call artist_merch to get an artist's or label's whole merch shop with each item's price, currency, type and sold-out f…. | band |
| discover | 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). | Research tools call discover to get bandcamp Discover with every filter the site has. | genre, subgenre, tags, format, location, ... |
| discover_options | The values `discover` accepts: the site's 26 genres with their sub-genres, the formats, sorts and time windows (no call to the site). | Community analysts call discover_options to get the values `discover` accepts. | none |
| locations | The site's own place lookup for Discover's location filter: matching cities / regions with their GeoNames ids. | Media monitors call locations to get the site's own place lookup for Discover's location filter. | query, limit |
| related_tags | Tags related to one or more Bandcamp tags, with the site's relation score (0-1). | Content platforms call related_tags to get tags related to one or more Bandcamp tags, with the site's relation score (0-1).. | tags, limit |
| sales_feed | 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. | Research tools call sales_feed to get bandcamp's live global sales feed. | since |
| fan | 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. | Community analysts call fan to get a fan's public profile. | fan |
| fan_collection | 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. | Media monitors call fan_collection to get every album and track in a fan's public collection, newest purchase first. | fan, cursor, per_page |
| fan_wishlist | A fan's public wishlist, same fields and paging as `fan_collection`. | Content platforms call fan_wishlist to get a fan's public wishlist, same fields and paging as `fan_collection`.. | fan, cursor, per_page |
| fan_following | 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`. | Research tools call fan_following to get who and what a fan follows. | fan, kind, cursor, per_page |
| fan_followers | The fans who follow a fan, with cursor paging. | Community analysts call fan_followers to get the fans who follow a fan, with cursor paging.. | fan, cursor, per_page |
| daily_articles | 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. | Media monitors call daily_articles to get bandcamp Daily article lists, newest first. | category, page |
| daily_article | 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). | Content platforms call daily_article to get one Bandcamp Daily article. | url |
| weekly_shows | The Bandcamp Weekly radio-show archive, newest first (every episode the site lists). | Research tools call weekly_shows to get the Bandcamp Weekly radio-show archive, newest first (every episode the site lists).. | page, per_page |
| weekly_show | One Bandcamp Weekly episode with its whole track list (artist, title, link, label, price, start time in the show). | Community analysts call weekly_show to get one Bandcamp Weekly episode with its whole track list (artist, title, link, label, price, sta…. | show_id |
Call search from your stack
curl -X POST https://api.reefapi.com/bandcamp/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"radiohead"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/bandcamp/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "radiohead"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/bandcamp/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "radiohead"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.bandcamp.search with {"query":"radiohead"}.Who uses this API and why
- Track vinyl, CD and cassette prices and stock across labels and artists.
- Watch Bandcamp's live sales feed for what sells, where and for how much.
- Build release calendars from Discover's new arrivals by genre, tag, format and city.
- Pull a label's whole catalogue and roster for A&R and distribution research.
- Find superfans of a release through its supporters, reviews and fan collections.
Questions developers ask before integrating
Do I need a Bandcamp account or API key from Bandcamp?
No. Everything is read logged out; you only need a ReefAPI key.
Does it return vinyl and CD stock?
Yes. Every physical format on a release page comes with price, currency, units left when the seller tracks stock, a sold-out flag that matched the page on 57 of 57 packages, edition size and size options with their own stock.
How deep does search go?
search returns Bandcamp's quick search, 50 rows per type in one call. search_pages returns the full results page by page, 18 rows each, with release date, track count and tags: Bandcamp lists up to 100 albums or mixed results (6 pages) and up to 500 tracks (28 pages) per query; "love" tracks ran 500 rows with no repeat across pages.
Which Discover filters work?
All of the site's: genre (26), sub-genre, any tag (several tags = releases carrying all of them), format (digital, vinyl, CD, cassette, t-shirt), artist location, best-selling, new arrivals or random, and time windows from today to six weeks ago. Each was measured to change the result: all releases 6,549,497; electronic 1,977,593; electronic + house 315,909; vinyl 245,249; London 44,036.
Can I list everything an artist or label has released?
Yes. artist returns the whole discography in one call with release date and link for every item (Hyperdub: 226 of 226), a label's artist roster and its merch list.
What is in the sales feed?
Every sale in the last 10 minutes Bandcamp publishes, with a 2-minute delay: album, track, merch or bundle, the artist, the amount paid in its currency and in US dollars, and the buyer's country. Pass the previous window_end_ts as since to follow it.
Are fan collections included?
Public ones: a fan's profile, collection and wishlist with title, artist, price and purchase date, the artists, fans and genres they follow, and their followers, all with cursor paging (703 collection items paged in 50s without a repeat).
Do I get audio files?
No. Track lists carry durations, lyrics and whether a track can be streamed, but no stream or download link.
What is the Bandcamp API?
Bandcamp API is a ReefAPI endpoint group for albums, tracks and merch with prices and stock, artists and labels, discover, the live sales feed, fans and bandcamp daily. It returns live JSON through POST requests under /bandcamp/v1.
Is the Bandcamp API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Bandcamp calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Bandcamp login or account?
No login to Bandcamp is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Bandcamp data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Bandcamp API use?
Bandcamp actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Bandcamp from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call bandcamp actions with the same key, credit pool and JSON envelope used by normal REST requests.