Podcasts
tier:standard

Get a podcast's format profile

Returns the full format breakdown for a podcast: how often episodes feature guests, detected production formats (interview, panel, call_in, solo_narrated), advertiser and video presence, episode length distribution, publishing cadence, the publish-day histogram, and the sample sizes behind each attribute. The compact form of this data is embedded as the format field on podcast responses; use this endpoint for the exact rates and distributions. Returns 404 when the podcast is not found or its format profile has not been computed yet.

get/v1/podcasts/{id}/format

Request

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

Path parameters

idstring required

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

Response

OK

ad_episode_ratenumber double required

Share of analyzed episodes carrying advertiser reads, in [0,1]

analyzed_episodesinteger required

Number of episodes with speaker analysis — the sample behind guest_frequency, signals, has_ads, and the rates below

avg_episode_minutesinteger

Average episode length in minutes. Omitted when no episode durations are known.

call_in_episode_ratenumber double required

Share of analyzed episodes with listener callers, in [0,1]

computed_atstring date-time required

When the profile was last recomputed

episode_countinteger required

Total episodes tracked for this podcast

episode_minutes_medianinteger

Median episode length in minutes

episode_minutes_p25integer

25th percentile episode length in minutes

episode_minutes_p75integer

75th percentile episode length in minutes

episodes_per_weeknumber double

Publishing cadence over the trailing 90 days, in episodes per week (e.g. 5.0 for a weekday daily, 0.5 for a fortnightly show). Omitted until the show has been tracked long enough to measure reliably.

first_episode_published_atstring date-time

Publish date of the earliest tracked episode

guest_episode_ratenumber double required

Share of analyzed episodes featuring at least one guest, in [0,1]

guest_frequencystring

How often episodes feature a guest: never, rare, occasional, regular, or always. Derived from the share of analyzed episodes with at least one guest speaker. Omitted when too few episodes have been analyzed to judge. Filter the catalog with the guest_frequency query parameter on GET /v1/podcasts.

has_adsboolean

Whether episodes carry advertiser reads. Omitted when too few episodes have been analyzed to judge. The full advertising profile (sponsors, read types, ad load) is served by GET /v1/podcasts/{id}/advertising.

has_videoboolean required

Whether any episode has a discovered video version (e.g. a YouTube release).

latest_episode_published_atstring date-time

Publish date of the most recent tracked episode

panel_episode_ratenumber double required

Share of analyzed episodes with panelists, in [0,1]

publishing_statusstring

Whether the show is still releasing episodes: active (published within the last 90 days) or dormant. Omitted when no publish dates are known.

signalsstring[] nullable

Production formats detected from the show's speaker-role mix: interview, panel, call_in, and/or solo_narrated. A show can carry several (a panel show with call-in segments). Omitted when too few episodes have been analyzed to judge.

Changes

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