Skip to navigation
API Referencepodcasts

Get a podcast

Retrieve one show. Always returns a single directory card.

A show that publishes under several feeds (mirrors, regional copies) is one merged entry here: every one of its feed ids resolves to the same card, and the card’s id is the canonical one to store and filter with.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

podcast_idstringRequired
The show to retrieve. Any feed id the show publishes under works.

Response headers

X-RateLimit-Limitinteger
Requests allowed per minute for this key's tier.
X-RateLimit-Remaininginteger
Requests remaining in the current window.
X-RateLimit-Resetinteger
Seconds until the window resets.

Response

Successful Response
idstring

Show id — the canonical id to store, and the value the podcast_ids search filter takes.

insight_countinteger
Total searchable insights across every episode of this show.
episode_countinteger
How many of the show's episodes produced searchable insights.
namestring or nullOptional
Display name of the show.
descriptionstring or nullOptional
The show's own description, as published on its feed.
image_urlstring or nullOptional
Show artwork.
latest_episode_atstring or nullOptional

When this show last produced searchable content — the freshness signal.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error