Get a podcast

Returns a single podcast by slug (e.g., 'all-in') or ID. Slugs are human-readable identifiers included in every podcast response.

get/v1/podcasts/{id}

Request

Base URL: https://api.particle.pro
URL: https://api.particle.pro/v1/podcasts/{id}
Auth: one of:
- API key in header X-API-Key
- HTTP bearer

Path parameters

idstring required

Podcast slug (e.g., 'all-in', 'lex-fridman-podcast'), internal ID, or numeric iTunes ID

Query parameters

topic_limitinteger

Maximum number of aggregated topics to return (0 for none, max 1000)

includestring[] nullable

Optional response sections. related attaches the five most related podcasts (lean form); recommended_guests the five guests the show could book next; recommended_sponsors (premium-grade, requires a plan with premium endpoints) the five advertisers active on shows like this one that do not buy it yet. Each has a paged endpoint for the full list: /related, /recommendations/guests, /recommendations/sponsors. coverage attaches how much of the show's history we know of and have transcribed, including its back catalogue.

Response

biasstring

Political bias rating for the podcast: EXTREME_LEFT, LEANS_LEFT, LEFT, CENTER, RIGHT, LEANS_RIGHT, or EXTREME_RIGHT. Empty when the podcast is not substantively political or has not been evaluated yet. Fetch GET /v1/podcasts/{id}/bias for the full analysis including reasoning and evidence.

descriptionstring

Podcast description

episode_countinteger

Total number of episodes

explicitboolean required

Whether the podcast contains explicit content

idstring required

Unique identifier

image_urlstring

Cover image URL

languagestring

ISO 639-1 language code

match_quality'exact' | 'partial' | 'fuzzy' | 'description' | 'speculative'

How confidently this result matches your q search, strongest first. exact: this is the show with that name. partial: the name matches your search strongly (your search may have included extra words). fuzzy: the name is similar but not the same — it may be the show you meant with a typo, or a different show with a near-identical name; verify before relying on it. description: your search text appears in the show's description rather than its name. speculative: a loose suggestion, listed last. When resolving a show programmatically, act on exact or partial results and treat anything weaker as candidates to confirm. Present only when q was provided.

political_contextstring

Political framework the bias rating is calibrated against: US, UK, EU, CANADA, AUSTRALIA, INDIA, OTHER. Omitted when the latest analysis returned NOT_POLITICAL or when no analysis has been run yet.

popularitynumber double

Global popularity percentile in (0,1], a cume_dist ranking over all currently-charting podcasts (Apple Podcasts charts). Higher is more popular; the most popular podcast is 1.0. Always global — never scoped to a topic_id or other filter. Omitted when the podcast is not currently charting. Pair with the popularity_threshold query parameter on GET /v1/podcasts to filter the catalog by this value.

slugstring

Human-readable slug identifier

suitability_tierstring

High-level brand-suitability verdict from the IAB Tech Lab Brand Safety & Suitability Framework (formerly GARM): SAFE, LIMITED, SENSITIVE, or UNSAFE. Empty when the podcast has not been evaluated yet. Per-category breakdown, evidence, and methodology are gated to GET /v1/podcasts/{id}/suitability.

titlestring required

Podcast title

urlstring

RSS feed URL

Changes

No recorded changes to this operation across all 2 revisions of this API.