Try the Search Bandcamp API

- **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): ```json { "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`.