Skip to navigation
API Referencepodcasts

List podcasts

Find a show by name — the step that turns a show name into the id the podcast_ids search filter takes.

Name matching is typo-tolerant (“eisamn” still finds The Real Eisman Playbook). Omit query to browse shows ranked by coverage. Only shows with searchable insights appear — absence means not covered, not “not found”.

Authentication

AuthorizationBearer

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

Query parameters

querystring or nullOptional2-200 characters

Show name to look up — typo-tolerant and case-insensitive. Omit to browse shows ranked by insight coverage.

limitintegerOptional1-100Defaults to 25
Shows per page, up to 100. 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
podcastslist of objects
One page of shows.
countinteger

Shows 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