PodHoodDocs
API Reference

List the channels your key can read

Every channel the key's owner is a member of — the discovery call that turns a bare key into the slugs the rest of the API is addressed by. apiAccess=false marks a channel whose owner's plan does not include the API: its data endpoints would answer 403.

GET
/api/v1/channels

Authorization

x-api-key<token>

A user-owned key created in Studio → Settings → API keys (paid plans). It reads the channels its owner is a member of.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/channels"
{  "channels": [    {      "id": "string",      "slug": "string",      "title": "string",      "providerType": "youtube",      "apiAccess": true    }  ]}
{  "error": "string"}
{  "error": "string"}
Was this page helpful?

Browse your channel's episodes

Keyset-paginated list of your channel's episodes — every non-archived status. Episode rows carry mediaUrl (the YouTube watch URL or RSS enclosure), so segment timestamps convert into source deep links. Pass the response's nextCursor back as cursor for the next page; the same facet filters as search apply.

Search your channel's episodes

Hybrid (semantic + keyword) search over your channel's episodes and transcripts — every non-archived status, drafts included. Returns ranked episodes with best-matching, timestamped segments; each segment carries a deep link to the exact moment. An empty result is 200 with an empty episodes array, never a 404.