Search Bandcamp API

Endpoint facts

Method

GET

API path

/bandcamp/search

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

Bandcamp

Execution

Managed browser rendering where the target needs it

Response schema

#/definitions/bandcamp.searchResponseDoc

How this endpoint behaves

Runs Bandcamp's site search and returns artists and labels, albums and tracks in Bandcamp's relevance order, with the tags and genre that match the text. It reads the JSON route behind the search box, so it needs no page rendering.

q is required: 1 to 100 characters (for example radiohead, dub techno or 日本). type selects what to return: all (default) mixes artists, albums and tracks; artists returns artists and labels; albums; tracks.

Notable response behavior:

• There is no paging. Bandcamp returns at most 50 hits (25 for artists). may_have_more is true when that cap was reached; narrow the text or choose a type to see further hits. total is the number of hits returned, not the number of matches on Bandcamp.
• results[].type is artist, album or track, and rank is the position in Bandcamp's order. In all, the order mixes the types, so a popular artist's albums can fill most of the 50.
• Artist rows carry location, genre, tags, is_label (true for labels) and url (the https://{subdomain}.bandcamp.com page). Album rows carry artist_id, artist_name, artist_url and tags. Track rows also carry album_id and album_name, which are empty for a single.
• url is accepted by bandcamp-release (albums and tracks) and bandcamp-artist (artists). image_url is a Bandcamp artwork URL.
• tags lists tags whose name matches the text (name, the tag slug that bandcamp-discover accepts, and count of tagged releases). genre appears when the text is a genre Bandcamp recognizes (for example jazz). Both are empty for typed searches.
• Fan accounts are never returned, even where Bandcamp mixes them into a result list.
• Text with no hits returns total: 0 and empty lists.

Example request: /api/v1/bandcamp/search?q=radiohead&type=all

Example response (trimmed to three of the 50 hits):

{
  "code": 200,
  "data": {
    "query": "radiohead",
    "type": "all",
    "total": 50,
    "may_have_more": true,
    "results": [
      {
        "rank": 1,
        "type": "artist",
        "id": 3957198221,
        "name": "Radiohead",
        "url": "https://radiohead.bandcamp.com",
        "location": "Oxford, UK",
        "genre": "Alternative",
        "tags": ["Alternative"],
        "image_url": "https://f4.bcbits.com/img/0047220904_23.jpg"
      },
      {
        "rank": 2,
        "type": "album",
        "id": 3317386587,
        "name": "KID A MNESIA",
        "url": "https://radiohead.bandcamp.com/album/kid-a-mnesia",
        "artist_id": 3957198221,
        "artist_name": "Radiohead",
        "artist_url": "https://radiohead.bandcamp.com",
        "tags": ["Alternative", "England", "Oxford", "United Kingdom"],
        "image_url": "https://f4.bcbits.com/img/3185643660_3.jpg"
      },
      {
        "rank": 24,
        "type": "track",
        "id": 3131312045,
        "name": "All I Need (Radiohead Cover)",
        "url": "https://spotlights.bandcamp.com/track/all-i-need-radiohead-cover",
        "artist_id": 1516729353,
        "artist_name": "Spotlights",
        "artist_url": "https://spotlights.bandcamp.com",
        "image_url": "https://f4.bcbits.com/img/3207173692_3.jpg"
      }
    ],
    "tags": [
      {
        "name": "RadioHead",
        "tag": "radiohead",
        "count": 8
      }
    ]
  },
  "msg": "OK"
}

Type values: all, artists, albums, tracks.

Sampled response

Request, 6 Nov 2026

GET /bandcamp/search?q=radiohead&type=artists

Items in results

25

Fields filled in every checked item

8

Fields empty in some or all items

1

Shared guides

Related