Podcast Episode API

GET /v1/episode/{id}

Fetch one episode by its PodKit episode id and get its full metadata plus a compact reference to the parent show. Handy when you’ve already got an episode id (from the metadata endpoint) and just need that one record — for a detail view, a webhook payload, or a citation.

Example

curl

curl "https://podkitapp.com/v1/episode/42" \
  -H "x-api-key: pk_your_key"

Response

{
  "id": 42,
  "guid": "ep-342",
  "title": "The state of AI agents",
  "pubDate": "2026-07-13T09:00:00.000Z",
  "audioUrl": "https://cdn.example.com/342.mp3",
  "duration": "42:11",
  "description": "This week we cover...",
  "podcast": { "id": 1200361736, "title": "The Daily Tech", "artist": "Example Media" }
}

The {id} here is a PodKit episode id (a stable serial assigned when PodKit ingests a feed), not the iTunes show id. You get episode ids from the metadata endpoint’s episodes[] list. Unknown ids return 404.

Send your key in the x-api-key header. Don’t have one? Get a free key (500 requests/month, no card).

Who uses it

Use it for episode detail pages, for re-fetching a single record without paging the whole show, or as the anchor an AI agent cites when it references a specific episode before pulling that episode’s chapters or transcript.

Get a free API key   Read the docs   See pricing

More PodKit APIs

Search APIMetadata APIChapters APITranscript API