crate.artistBandcampRelease(key, item)
artistBandcampRelease(key: string, item: string, opts?: RequestOptions): Promise<ArtistBandcampReleaseResponse>Fetch one Bandcamp release addressed under its artist — the full tracklist (with per-track duration_s), fetchable artwork URLs, label, tags, and economics. The cluster-attached per-release grain: list item ids from an artist dossier’s bandcamp_releases facet, then hand (key, item) here for the detail. Cluster-first integrity: if the release is unknown OR filed under a different artist, the response is the honest gap { present: false, note } — never another artist’s data, never a 404. Branch on present.
| Endpoint | GET /api/v2/artist/{key}/bandcamp/{item} |
| Auth | key |
| Returns | ArtistBandcampReleaseResponse |
| Retryable | yes |
| Idempotent | yes |
Example
Section titled “Example”const r = await crate.artistBandcampRelease(clusterId, '2783508421');if (r.present) console.log(r.release.title, r.release.tracks.length);Throws
Section titled “Throws”CrateAPIError— on a non-2xx response.