Skip to main content
GET
cURL

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

​
q
string

Search the catalog by podcast name. GET /v1/podcasts/search is the canonical search endpoint and accepts the same parameters. 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
​
sort
enum<string>

Result ordering. relevance — the default whenever q is present — ranks by how well each podcast matches the query, breaking ties by popularity. popularity orders purely by the global popularity percentile (most popular first; podcasts not currently charting sort last), and also overrides topic_id's concentration ordering. Without q or topic_id, results are popularity-ordered either way.

Available options:
relevance,
popularity
​
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:
​
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:
​
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

OK

​
data
object[] | null
required

List of results

​
has_more
boolean
required

Whether more results exist

​
cursor
string

Pass to next request for more results