{"openapi":"3.1.0","info":{"title":"Bandcamp API","version":"1.0.0","description":"Live data from Bandcamp, the independent-music marketplace and streaming platform, with no account and no key. Bandcamp is where independent artists and labels sell and stream music directly to fans; this reads Bandcamp's own public web/mobile JSON and returns clean results. Search across bands, albums, tracks and labels by name (each result with its kind, name, artist, page url, location and cover art); read an album or track in full — its artist, full tracklist with durations, price and currency (many releases are free or name-your-price), release date, tags and cover art; and read a band/artist profile with its complete discography. The artist-direct music-commerce layer for music discovery, price-comparison, fan tools and analytics. Distinct from streaming-catalogue and record-database APIs — this is Bandcamp's own marketplace. Live from Bandcamp; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bandcamp-api","description":"oanor gateway"}],"tags":[{"name":"Search"},{"name":"Album"},{"name":"Band"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search bands, albums, tracks, labels","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"radiohead"},{"name":"type","in":"query","required":false,"description":"Filter: band, album or track","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Search Bandcamp across bands, albums, tracks and labels — each result with its kind, name, artist, page url, location and cover art. Filter with type=band|album|track. The discovery entry point into Bandcamp's independent-music marketplace.","count":25,"query":"radiohead","source":"Bandcamp","results":[{"id":3957198221,"art":"https://f4.bcbits.com/img/a40867508_10.jpg","url":"https://radiohead.bandcamp.com","kind":"band","name":"Radiohead","is_label":false,"location":"Oxford, UK","tag_names":["Alternative"]},{"id":3317386587,"art":"https://f4.bcbits.com/img/a3185643660_10.jpg","url":"https://radiohead.bandcamp.com","kind":"album","name":"KID A MNESIA","artist":"Radiohead","band_id":3957198221,"is_label":false,"tag_names":[]},{"id":2162872411,"art":"https://f4.bcbits.com/img/a552435637_10.jpg","url":"https://radiohead.bandcamp.com","kind":"album","name":"In Rainbows","artist":"Radiohead","band_id":3957198221,"is_label":false,"tag_names":[]},{"id":2045365829,"art":"https://f4.bcbits.com/img/a2501641316_10.jpg","url":"https://radiohead.bandcamp.com","kind":"album","name":"OK Computer","artist":"Radiohead","band_id":3957198221,"is_label":false,"tag_names":[]},{"id":3253272115,"art":"https://f4.bcbits.com/img/a138267232_10.jpg","url":"https://radiohead.bandcamp.com","kind":"album","name":"The Bends","artist":"Radiohead","band_id":3957198221,"is_label":false,"tag_names":[]},{"id":2788392198,"art":"https://f4.bcbits.com/img/a808547322_10.jpg","url":"https://radiohead.bandcamp.com","kind":"album","name":"Kid A","artist":"Radiohead","band_id":3957198221,"is_label":false,"tag_names":[]},{"id":1003295408,"art":"https://f4.bcbits.com/img/a2371540921_10.jpg","url":"https://amandapalmer.bandcamp.com","kind":"album","name":"Amanda Palmer Performs The Popular Hits Of Radiohead On Her Magical Ukulele","artist":"Amanda Palmer","band_id":3463798201,"is_label":false,"tag_names":[]},{"id":542090643,"art":"https://f4.bcbits.com/img/a3074823003_10.jpg","url":"https://joshcohenmusic.bandcamp.com","kind":"album","name":"Radiohead for Solo Piano","artist":"Josh Cohen","band_id":1576490711,"is_label":false,"tag_names":[]},{"id":655681187,"art":"https://f4.bcbits.com/img/a2238314030_10.jpg","url":"https://amplive.bandcamp.com","kind":"album","name":"Radiohead Rainydayz Remixes","artist":"Amp Live","band_id":105297554,"is_label":false,"tag_names":[]},{"id":3073062335,"art":"https://f4.bcbits.com/img/a22055244_10.jpg","url":"https://djrhbeats.bandcamp.com","kind":"band","name":"Dj Radiohead","is_label":false,"location":"Montreal, Québec","tag_names":["rap","instrumental hip-hop","underground hip-hop","conscious hip-hop","Hip-Hop/Rap","boom bap beats"]},{"id":2245293767,"art":"https://f4.bcbits.com/img/a171096933_10.jpg","url":"https://lottekestner.bandcamp.com","kind":"album","name":"Radiohead Covers compilation","artist":"Lotte Kestner","band_id":2632630330,"is_label":false,"tag_names":[]},{"id":2676308921,"art":"https://f4.bcbits.com/img/a2257175011_10.jpg","url":"https://angelimanucheproductions.bandcamp.com","kind":"album","name":"22.22 Free Radiohead","artist":"Paolo Angeli","band_id":2234613848,"is_label":false,"tag_names":[]},{"id":3366497937,"art":"https://f4.bcbits.com/img/a879587302_10.jpg","url":"https://waldosgift.bandcamp.com","kind":"album","name":"Radiohead Reworks","artist":"Waldo's Gift","band_id":11180647,"is_label":false,"tag_names":[]},{"id":3544404259,"art":"https://f4.bcbits.com/img/a3027340101_10.jpg","url":"https://bigpauper.bandcamp.com","kind":"album","name":"Me & THIS Army: Radiohead Remixed & Mashed Up by PZ","artist":"Panzah Zandahz","band_id":1522944075,"is_label":false,"tag_names":[]},{"id":3889078033,"art":"https://f4.bcbits.com/img/a4164891505_10.jpg","url":"https://blackmarketdub.bandcamp.com","kind":"album","name":"Radiohead / Dub","artist":"Black Market Dub & Wise Owl","band_id":2806703770,"is_label":false,"tag_names":[]},{"id":3147385211,"art":"https://f4.bcbits.com/img/a770695032_10.jpg","url":"https://radioheadtwo.bandcamp.com","kind":"band","name":"radiohead two","is_label":false,"location":"Amsterdam, Netherlands","tag_names":["Pop","emo","indie pop"]},{"id":3545604552,"art":"https://f4.bcbits.com/img/a3888784356_10.jpg","url":"https://hellvetika.bandcamp.com","kind":"album","name":"Radiohead // redux","artist":"Hellvetika","band_id":2999189977,"is_label":false,"tag_names":[]},{"id":3344586338,"art":"https://f4.bcbits.com/img/a2511013603_10.jpg","url":"https://prfmonthlytributeseries.bandcamp.com","kind":"album","name":"November 2021: Radiohead","artist":"PRF Monthly Tribute Series","band_id":4195141223,"is_label":false,"tag_names":[]},{"id":3858766918,"art":"https://f4.bcbits.com/img/a2976398612_10.jpg","url":"https://steeplejackrecc.bandcamp.com","kind":"album","name":"Have You Heard of Radiohead?","artist":"Faultlines","band_id":2410959934,"is_label":false,"tag_names":[]},{"id":1516946785,"art":"https://f4.bcbits.com/img/a1885883684_10.jpg","url":"https://thehmc.bandcamp.com","kind":"album","name":"Radiohead - Kid A","artist":"Halifax Music Co-op","band_id":1087641733,"is_label":false,"tag_names":[]},{"id":3857158525,"art":"https://f4.bcbits.com/img/a1236561760_10.jpg","url":"https://tigermendoza.bandcamp.com","kind":"album","name":"Reckoner / Nude Remixes (2019 Remaster)","artist":"Radiohead","band_id":1548034878,"is_label":false,"tag_names":[]},{"id":3482212741,"art":"https://f4.bcbits.com/img/a3447681758_10.jpg","url":"https://robewing.bandcamp.com","kind":"album","name":"Electrojazz Tribute to Radiohead","artist":"Disappear Incompletely","band_id":2900821443,"is_label":false,"tag_names":[]},{"id":887484167,"art":"https://f4.bcbits.com/img/a1665127009_10.jpg","url":"https://ifarmusiqueconcretecompilation.bandcamp.com","kind":"album","name":"RADIOHEAD","artist":"various","band_id":1913155531,"is_label":false,"tag_names":[]},{"id":1612021511,"art":"https://f4.bcbits.com/img/a662283523_10.jpg","url":"https://jaideneveda.bandcamp.com","kind":"album","name":"\"CREEP\" RADIOHEAD (strings serenade) ep","artist":"jaidene veda","band_id":1032302901,"is_label":false,"tag_names":[]},{"id":3131312045,"art":"https://f4.bcbits.com/img/a3207173692_10.jpg","url":"https://spotlights.bandcamp.com","kind":"track","name":"All I Need (Radiohead Cover)","artist":"Spotlights","band_id":1516729353,"is_label":false,"tag_names":[]}]},"meta":{"timestamp":"2026-06-14T17:03:42.882Z","request_id":"e933c395-7780-45a2-ac5c-fc0a99e21d31"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/album":{"get":{"operationId":"get_v1_album","tags":["Album"],"summary":"One release in full (album or track)","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Resolve the top album/track match by name","schema":{"type":"string"},"example":"boards of canada"},{"name":"band_id","in":"query","required":false,"description":"Band id (with tralbum_id)","schema":{"type":"string"}},{"name":"tralbum_id","in":"query","required":false,"description":"Album/track id","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"a (album) or t (track)","schema":{"type":"string"},"example":"a"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":477965531,"art":"https://f4.bcbits.com/img/a3190407865_10.jpg","url":"https://boardsofcanada.bandcamp.com/album/inferno","note":"One Bandcamp release (album or track) in full: its artist, full tracklist with durations, price and currency (many are free or name-your-price), release date, tags and cover art. Pass band_id + tralbum_id (+ type=a|t), or q to resolve the top match.","tags":["Alternative","Electronic"],"type":"a","title":"Inferno","artist":"Boards of Canada","source":"Bandcamp","tracks":[{"title":"Introit","duration":35.9999,"track_num":1},{"title":"Prophecy At 1420 MHz","duration":304.499,"track_num":2},{"title":"Hydrogen Helium Lithium Leviathan","duration":284.851,"track_num":3},{"title":"Age Of Capricorn","duration":232.55,"track_num":4},{"title":"Father And Son","duration":204.835,"track_num":5},{"title":"Somewhere Right Now In The Future","duration":146.715,"track_num":6},{"title":"Naraka","duration":301.238,"track_num":7},{"title":"Acts Of Magic","duration":78.1872,"track_num":8},{"title":"Memory Death","duration":157.95,"track_num":9},{"title":"The Word Becomes Flesh","duration":320.1,"track_num":10},{"title":"Into The Magic Land","duration":275.175,"track_num":11},{"title":"Blood In The Labyrinth","duration":295.725,"track_num":12},{"title":"Deep Time","duration":198.9,"track_num":13},{"title":"All Reason Departs","duration":374.4,"track_num":14},{"title":"Arena Americanada","duration":322.2,"track_num":15},{"title":"The Process","duration":181.2,"track_num":16},{"title":"You Retreat In Time And Space","duration":325.5,"track_num":17},{"title":"I Saw Through Platonia","duration":159.975,"track_num":18}],"band_id":4138854288,"is_free":false,"currency":"GBP","track_count":18,"release_date":1780012800},"meta":{"timestamp":"2026-06-14T17:03:43.417Z","request_id":"b3a3b998-0f9e-4fab-b416-5a8e0eb5a400"},"status":"ok","message":"Album retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/band":{"get":{"operationId":"get_v1_band","tags":["Band"],"summary":"A band/artist profile + discography","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Resolve the top band match by name","schema":{"type":"string"},"example":"radiohead"},{"name":"band_id","in":"query","required":false,"description":"Band id (numeric)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":3957198221,"art":"https://f4.bcbits.com/img/a40867508_10.jpg","url":"https://radiohead.bandcamp.com","name":"Radiohead","note":"A Bandcamp band/artist profile: its name, location, bio, page url and its full discography (every album and track released), each with title, release date and art. Pass band_id (from /v1/search), or q to resolve the top band match.","source":"Bandcamp","location":"Oxford, UK","discography":[{"id":365742988,"art":"https://f4.bcbits.com/img/a454733928_10.jpg","type":"album","title":"Hail to the Thief (Live Recordings 2003-2009)","release_date":"13 Aug 2025 00:00:00 GMT"},{"id":3317386587,"art":"https://f4.bcbits.com/img/a3185643660_10.jpg","type":"album","title":"KID A MNESIA","release_date":"05 Nov 2021 00:00:00 GMT"},{"id":3293551680,"art":"https://f4.bcbits.com/img/a1866183002_10.jpg","type":"album","title":"OK Computer OKNOTOK 1997 2017","release_date":"23 Jun 2017 00:00:00 GMT"},{"id":1880809236,"art":"https://f4.bcbits.com/img/a3154171150_10.jpg","type":"album","title":"In Rainbows (Disk 2)","release_date":"14 Oct 2016 00:00:00 GMT"},{"id":190478553,"art":"https://f4.bcbits.com/img/a4212377151_10.jpg","type":"album","title":"A Moon Shaped Pool","release_date":"08 May 2016 00:00:00 GMT"},{"id":2941363459,"art":"https://f4.bcbits.com/img/a2486005434_10.jpg","type":"album","title":"TKOL RMX 1234567","release_date":"10 Oct 2011 00:00:00 GMT"},{"id":712041058,"art":"https://f4.bcbits.com/img/a2929804922_10.jpg","type":"album","title":"The King Of Limbs","release_date":"18 Feb 2011 00:00:00 GMT"},{"id":2162872411,"art":"https://f4.bcbits.com/img/a552435637_10.jpg","type":"album","title":"In Rainbows","release_date":"28 Dec 2007 00:00:00 GMT"},{"id":4164667409,"art":"https://f4.bcbits.com/img/a2328851828_10.jpg","type":"album","title":"Hail To the Thief","release_date":"09 Jun 2003 00:00:00 GMT"},{"id":3408559411,"art":"https://f4.bcbits.com/img/a3978859367_10.jpg","type":"album","title":"I Might Be Wrong","release_date":"12 Nov 2001 00:00:00 GMT"},{"id":4221162017,"art":"https://f4.bcbits.com/img/a3680642761_10.jpg","type":"album","title":"Amnesiac","release_date":"12 Mar 2001 00:00:00 GMT"},{"id":2788392198,"art":"https://f4.bcbits.com/img/a808547322_10.jpg","type":"album","title":"Kid A","release_date":"02 Oct 2000 00:00:00 GMT"},{"id":2045365829,"art":"https://f4.bcbits.com/img/a2501641316_10.jpg","type":"album","title":"OK Computer","release_date":"28 May 1997 00:00:00 GMT"},{"id":3253272115,"art":"https://f4.bcbits.com/img/a138267232_10.jpg","type":"album","title":"The Bends","release_date":"13 Mar 1995 00:00:00 GMT"},{"id":1567285707,"art":"https://f4.bcbits.com/img/a1879118287_10.jpg","type":"album","title":"Pablo Honey","release_date":"22 Feb 1993 00:00:00 GMT"}],"discography_count":15},"meta":{"timestamp":"2026-06-14T17:03:43.934Z","request_id":"febdd230-164c-472d-bfd0-28ff9dc555a2"},"status":"ok","message":"Band retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"top":"Radiohead"},"source":"Bandcamp public web/mobile API (bandcamp.com/api), keyless","service":"bandcamp-api","endpoints":{"GET /v1/band":"A band/artist profile + discography (band_id, or q for the top match).","GET /v1/meta":"This document.","GET /v1/album":"One release in full (band_id + tralbum_id + type, or q for the top match).","GET /v1/search":"Search bands/albums/tracks/labels (q, type=band|album|track, limit)."},"description":"Live Bandcamp independent-music marketplace data with no key: search across bands, albums, tracks and labels; read an album or track in full (artist, tracklist, price, release date, tags, art); and read a band/artist profile with its discography. The artist-direct music-commerce layer for discovery, price tools and analytics. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:03:44.028Z","request_id":"d6e40bc4-bbbd-4a20-b624-5cab94aeb7a4"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":720,"monthly_call_quota":182000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2480,"monthly_call_quota":950000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":7150,"monthly_call_quota":5900000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bandcamp-api"}