Get a podcast's format profile

{ "ad_episode_rate": 123, "analyzed_episodes": 123, "call_in_episode_rate": 123, "computed_at": "2023-11-07T05:31:56Z", "episode_count": 123, "guest_episode_rate": 123, "has_video": true, "panel_episode_rate": 123, "publish_days": { "friday": 123, "monday": 123, "saturday": 123, "sunday": 123, "thursday": 123, "tuesday": 123, "wednesday": 123 }, "avg_episode_minutes": 123, "episode_minutes_median": 123, "episode_minutes_p25": 123, "episode_minutes_p75": 123, "episodes_per_week": 123, "first_episode_published_at": "2023-11-07T05:31:56Z", "guest_frequency": "<string>", "has_ads": true, "latest_episode_published_at": "2023-11-07T05:31:56Z", "publishing_status": "<string>", "signals": [ "<string>" ] }

Authorizations

X-API-Key

string

header

required

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

Path Parameters

string

required

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

Response

ad_episode_rate

number<double>

required

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

analyzed_episodes

integer<int64>

required

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

call_in_episode_rate

number<double>

required

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

computed_at

string<date-time>

required

When the profile was last recomputed

episode_count

integer<int64>

required

Total episodes tracked for this podcast

guest_episode_rate

number<double>

required

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

has_video

boolean

required

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

panel_episode_rate

number<double>

required

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

publish_days

object

required

Histogram of episodes by publish day of week

Show child attributes

avg_episode_minutes

integer<int64>

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

episode_minutes_median

integer<int64>

Median episode length in minutes

episode_minutes_p25

integer<int64>

25th percentile episode length in minutes

episode_minutes_p75

integer<int64>

75th percentile episode length in minutes

episodes_per_week

number<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_at

string<date-time>

Publish date of the earliest tracked episode

guest_frequency

string

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_ads

boolean

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.

latest_episode_published_at

string<date-time>

Publish date of the most recent tracked episode

publishing_status

string

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

signals

string[] | null

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.