Search podcast dialogue for entity mentions
Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency. Each result is one episode plus all of that episode’s mention windows — a window is a contiguous range of dialogue containing the mention with context_lines of surrounding context, and lines containing the mention have is_mention=true.
Mentions inside ad reads are excluded by default; pass include_ads=true to include them.
Subjects with no knowledge graph entity (most podcast guests, smaller companies) are matched by scanning dialogue for their name verbatim instead of curated entity tags; such pages carry matched_by: "name" and echo the resolved person or company instead of entity.
Use this endpoint for the “every line about X” use case. For finding dialogue by topic or exact phrase use /v1/podcasts/episodes/search instead.
Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Entity slug (e.g., 'sam-altman') or ID. A person slug or ID resolves via the person's linked knowledge graph entity; a person with no linked entity falls back to name matching (matched_by=name). Required when company_id is not set.
Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity; a company with no linked entity falls back to name matching (matched_by=name).
Restrict to mentions inside one podcast.
Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.
Restrict to mentions inside one episode by slug or ID (cross-corpus result still surfaces a single episode group).
Constrain how the entity participates: guest, host, panelist, correspondent, or mention.
guest, host, panelist, correspondent, mention Result ordering. recency (the default) returns the most recently published episodes first. popularity orders by the parent podcast's global popularity percentile — the biggest shows first, recency breaking ties within a show, non-charting podcasts last. Pass the same sort alongside a cursor when paginating.
recency, popularity Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.
Only episodes published after this date.
"2024-01-01"
Only episodes published before this date.
"2024-06-01"
Surrounding dialogue lines around each mention.
0 <= x <= 20Episodes per page (1-100, default 25). Each episode's full set of mention windows is returned in a single page; episodes never split across pages.
1 <= x <= 100Opaque cursor from a previous response.
Response
OK
Episodes on this page, ordered by recency (default) or salience
More episodes available
Resolved company, when company_id filtered the result set. Omitted when only entity_id was provided.
Opaque cursor; pass back as ?cursor= for the next page
Resolved entity. Omitted on empty pages where neither entity_id nor company_id resolved, and on name-matched pages (see matched_by) where the subject has no knowledge graph entity.
How mention lines were matched. Omitted for the default knowledge-graph tag matching; 'name' when the subject has no knowledge graph entity and dialogue was scanned for the subject's name verbatim.
Resolved person, when entity_id resolved to a person with no linked knowledge graph entity (name-match fallback).