← Back to EcomCentral
BANDCAMP PUBLIC API

Bandcamp Setup Guide

Connect your Bandcamp artist account to EcomCentral using OAuth2 access token authentication to browse your discography and release details.

About Bandcamp

Bandcamp is a music marketplace that lets artists sell music and merchandise directly to fans. Artists retain high revenue shares and maintain direct relationships with buyers. EcomCentral connects to Bandcamp's public API to browse your discography (albums, tracks, and merch packages) and view release details including tracklists and physical package information.

⚠ Limitations: Bandcamp's public API does not expose order/sales data, stock management, or tracking. These are managed exclusively via the Bandcamp Artists dashboard. You can export sales reports as CSV from your Bandcamp dashboard.

Prerequisites

Finding Your Band ID

Your Band ID is a numeric identifier for your Bandcamp artist account. There are two ways to find it:

  1. Log in to bandcamp.com and go to your artist page
  2. Open your browser's developer tools (F12) and go to the Network tab
  3. Reload the page and inspect any API call — your Band ID appears in the request parameters as band_id
  4. Alternatively, go to Settings → Account on bandcamp.com — the Band ID may appear in the page URL or in the page source as "band_id"
ℹ️ If you registered a developer app, your Band ID is also shown in the Bandcamp Developer portal under your app settings.

Obtaining an Access Token

  1. Go to bandcamp.com/developer and sign in with your Bandcamp account
  2. Register a new application — provide a name, description, and redirect URI (can be http://localhost for testing)
  3. Note your application's Client ID and Client Secret
  4. Follow Bandcamp's OAuth2 authorization code flow to obtain a user access token for your band
  5. Exchange the authorization code for an access token — this is the value you enter in EcomCentral
⚠️ Access tokens expire. If EcomCentral returns a 401 Unauthorized error, refresh your OAuth2 token and update your EcomCentral connection credentials.
✅ The access token is sent as a URL query parameter (?access_token=…) on every API call. Keep it private and do not share it publicly.

Connection Credentials

KeyRequiredDescriptionExample
band_id Required Your numeric Bandcamp Band ID. Found in artist settings or developer portal. 987654
access_token Required OAuth2 access token from the Bandcamp developer OAuth2 flow. Appended as a query param on every request. eyJhb…
✅ Alternative key names accepted: bandId for the band ID; accessToken or token for the access token.

API Endpoints Used

OperationMethodEndpoint
Test connection GET /band/3/info?band_id={band_id}&access_token={token}
Discography (products) GET /band/3/discography?band_id={band_id}&access_token={token}
Release detail (tracklist) GET /band/3/tralbum_details?band_id={band_id}&tralbumId={id}&access_token={token}
ℹ️ All requests are GET only — the Bandcamp public API exposes only read endpoints. Authentication is via access_token as a URL query parameter (not an Authorization header). The discography endpoint returns a bare JSON array; all other endpoints return plain JSON objects.

Supported Features

FeatureSupportedNotes
Test Connection ✅ Hits /band/3/info — confirms band_id and access_token are valid
Orders ❌ Use Bandcamp Artists dashboard to view and export orders
Order Detail ❌ Not available via the public API
Products (Discography) ✅ Albums, tracks, and merch packages from /band/3/discography
Product Detail (Tracklist) ✅ Full tracklist, duration, and physical package info via /band/3/tralbum_details
Stock Management ❌ Digital content has no stock concept; physical packages are read-only via public API
Push Tracking ❌ Digital delivery is automatic; physical order tracking is managed on Bandcamp

Troubleshooting

401 Unauthorized

The access token is wrong, expired, or has been revoked. OAuth2 tokens have a limited lifetime — refresh your token via the Bandcamp OAuth2 flow and update your EcomCentral connection credentials. Make sure you copy the full token without any leading or trailing whitespace.

403 Forbidden

The access token is valid but does not belong to the band identified by band_id. Verify that the Band ID you entered matches your Bandcamp artist account. Each OAuth2 token is scoped to the account that authorized it.

Rate Limiting

Bandcamp's public API enforces rate limits. If you receive 429 Too Many Requests, wait a few seconds and try again. EcomCentral does not cache API responses — repeated rapid refreshes of the discography view may trigger rate limits.

Empty discography

If the discography returns no items, verify that you have published releases on your Bandcamp page. Drafts and unpublished releases may not appear in the API response.

🔧 Quick sanity check — verify your credentials return band info by hitting:
https://bandcamp.com/api/band/3/info?band_id=YOUR_BAND_ID&access_token=YOUR_TOKEN
in a browser or API client. A 200 response with your band name confirms both credentials are correct.