API Referenceepisodes

List episodes

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

Authentication

AuthorizationBearer

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

OR
X-API-Keystring
API Key authentication via header

Query parameters

querystring or nullOptional2-200 characters

Case-insensitive episode-title match.

podcast_idstring or nullOptional

Scope to one show (sonic podcast id).

date_fromstring or nullOptional

ISO 8601; bare dates are UTC day boundaries.

date_tostring or nullOptional

ISO 8601; bare dates include the whole day.

limitintegerOptional1-200Defaults to 25
cursorstring or nullOptional

next_cursor from the previous page.

Response

Successful Response
episodeslist of objects
countinteger
next_cursorstring or nullOptional

Errors

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