List and search podcasts

{ "data": [ { "explicit": true, "id": "<string>", "title": "<string>", "bias": "<string>", "description": "<string>", "episode_count": 123, "format": { "has_video": true, "avg_episode_minutes": 123, "episodes_per_week": 123, "guest_frequency": "<string>", "has_ads": true, "publishing_status": "<string>", "signals": [ "<string>" ] }, "image_url": "<string>", "language": "<string>", "political_context": "<string>", "popularity": 123, "publisher": { "id": "<string>", "name": "<string>", "slug": "<string>" }, "slug": "<string>", "speakers": [ { "name": "<string>", "entity": { "id": "<string>", "name": "<string>", "slug": "<string>", "company": { "id": "<string>", "domain": "<string>", "ticker": "<string>" }, "description": "<string>", "person": { "id": "<string>", "company": "<string>", "image_url": "<string>", "title": "<string>" }, "type": { "name": "<string>", "slug": "<string>" }, "wikipedia_url": "<string>" }, "occurrences": 123, "role": "<string>" } ], "suitability_tier": "<string>", "topics": [ { "id": "<string>", "name": "<string>", "slug": "<string>", "ancestry": "<string>", "ancestry_path": "<string>", "episode_count": 123 } ], "url": "<string>" } ], "has_more": true, "cursor": "<string>" }

Authorizations

X-API-Key

string

header

required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

limit

integer<int64>

default:25

Results per page

Required range: 1 <= x <= 100

cursor

string

Opaque pagination cursor from previous response

string

Search the catalog by podcast name. The search is forgiving: it handles typos, missing or extra words ('offline jon favreau' finds Offline with Jon Favreau), a name plus qualifiers ('equity techcrunch'), and pasted episode titles ('Ferrari | Acquired' finds Acquired). The best matches come first, and each result's match_quality tells you how confident the match is — including when a show matched only through its description (match_quality=description) rather than its name.

Maximum string length: 200

slug

string

Filter by exact podcast slug (e.g., 'all-in'). Slugs are stable, human-readable identifiers returned on every podcast object.

Maximum string length: 200

topic_id

string

Filter by topic ID, ancestry slug (e.g., technology/artificial-intelligence), or ancestry path hash. Matches podcasts where the topic accounts for at least 20% of the show's episodes, ranked by topic concentration — not merely podcasts that mention it once.

language

string

Filter by language (ISO 639-1 code, e.g. 'en', 'es')

suitability_tier

enum<string>

Filter by brand-suitability tier (IAB Tech Lab Brand Safety & Suitability Framework, formerly GARM). Only returns podcasts whose most recent suitability analysis assigned this tier. Podcasts without a suitability analysis are excluded when this filter is set.

Available options:

SAFE,

LIMITED,

SENSITIVE,

UNSAFE

popularity_threshold

number<double>

Restrict results to podcasts whose global popularity percentile is at least this value (accepted range [0,1]). Omitting the parameter or passing 0 disables the filter; only a value greater than 0 activates it. Popularity is always global — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts) — never scoped to topic_id or any other filter. When the filter is active (threshold > 0), podcasts not currently charting have no percentile and are excluded, so a high threshold combined with a narrow topic_id may return zero results; lower or remove the threshold to widen the set.

Required range: 0 <= x <= 1

guest_frequency

enum<string>[] | null

Filter by how often episodes feature a guest. Pass a comma-separated list to match any of several buckets — e.g. regular,always for interview-driven shows, or never for shows that don't host guests. Only matches podcasts with enough analyzed episodes to judge; values mirror the format.guest_frequency field on podcast responses.

Maximum array length: 5

Available options:

never,

rare,

occasional,

regular,

always

Example:

["regular", "always"]

format_signal

enum<string>[] | null

Filter by detected production format. Pass a comma-separated list to match any of several formats — e.g. panel,call_in. Values mirror the format.signals field on podcast responses; a show can carry several signals.

Maximum array length: 4

Available options:

interview,

panel,

call_in,

solo_narrated

Example:

["interview"]

has_ads

enum<string>

Filter by advertiser presence. Pass false to find ad-free shows — an assertion that requires the show to have enough analyzed episodes, so sparsely-analyzed podcasts are excluded rather than presumed ad-free.

Available options:

true,

false

has_video

enum<string>

Filter by whether episodes have discovered video versions (e.g. YouTube releases).

Available options:

true,

false

min_avg_episode_minutes

integer<int64>

Only podcasts whose average episode runs at least this many minutes. Combine with max_avg_episode_minutes to target a length band (e.g. 20–40 minute commute shows).

Required range: 0 <= x <= 10080

max_avg_episode_minutes

integer<int64>

Only podcasts whose average episode runs at most this many minutes.

Required range: 0 <= x <= 10080

min_episodes_per_week

number<double>

Only podcasts publishing at least this many episodes per week on average (e.g. 5 for weekday dailies). Cadence is measured over the trailing 90 days; podcasts tracked too briefly to measure are excluded.

Required range: x >= 0

max_episodes_per_week

number<double>

Only podcasts publishing at most this many episodes per week on average (e.g. 0.5 for fortnightly-or-slower shows).

Required range: x >= 0

publishing_status

enum<string>

Filter by publishing activity: active shows have released an episode within the last 90 days; dormant shows have not.

Available options:

active,

dormant

Response

data

object[] | null

required

List of results

Show child attributes

has_more

boolean

required

Whether more results exist

cursor

string

Pass to next request for more results