Skip to navigation
API Referenceepisodes

List episodes

Find episodes by title, show, and/or date window — newest first. Only episodes with searchable insights are listed.

Use an episode’s id in the episode_ids search filter to scope retrieval to that one conversation.

Authentication

AuthorizationBearer

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

Query parameters

querystring or nullOptional2-200 characters

Episode-title match — typo-tolerant on its own; exact (case-insensitive) when combined with podcast_id or a date window.

podcast_idstring or nullOptional

Scope to one show — the podcast id from the directory.

date_fromstring or nullOptional

Earliest published_at to include, inclusive. ISO 8601; a bare date starts at UTC midnight.

date_tostring or nullOptional

Latest published_at to include, inclusive — a bare date covers the whole day.

limitintegerOptional1-200Defaults to 25
Episodes per page, up to 200. Default 25.
cursorstring or nullOptional

next_cursor from the previous page.

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
episodeslist of objects
One page of episodes, newest first.
countinteger

Episodes in this page — not the total matching the query.

next_cursorstring or nullOptional

Pass back as cursor to fetch the next page. null on the last page.

Errors

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