Getting Started with Supercast

Base URL

All API requests are made to:

https://<your-subdomain>.supercast.com/api/v1/

Authentication

Every API request must include a Bearer token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

You can also pass it as a query parameter, though the header is preferred:

GET /api/v1/episodes?access_token=YOUR_ACCESS_TOKEN

Getting a token

The easiest way to get an access token is to generate one in the Supercast dashboard under Settings → API. These tokens are scoped to your channel and work immediately — no OAuth flow required.

Error responses

All errors follow a consistent shape:

{
  "error": "A human-readable message describing what went wrong"
}