Skip to navigation
API Referenceepisodes

Get an episode

Retrieve one episode — the episode_id on any insight resolves here directly.

Authentication

AuthorizationBearer

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

Path parameters

episode_idstringRequired

The episode to retrieve — the episode_id carried on every insight.

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

Episode id. Every insight from this conversation carries it as episode_id, and the episode_ids search filter accepts it.

insight_countinteger

How many searchable insights this conversation yielded — a dense discussion runs to dozens, a passing segment to one or two.

titlestring or nullOptional
Episode title.
published_atstring or nullOptional

When the episode aired — ISO 8601 UTC.

duration_secondsinteger or nullOptional
Length of the recording, in seconds.
episode_audio_urlstring or nullOptional

Full episode audio. Pair with an insight’s start_seconds to play a claim at the moment it was said.

episode_urlstring or nullOptional
Public web page for the episode.
episode_image_urlstring or nullOptional
Episode artwork.
podcast_idstring or nullOptional
Id of the show this episode belongs to.
podcast_namestring or nullOptional
Display name of the show.
podcast_image_urlstring or nullOptional
Show artwork.

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