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.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/mentions
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
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.
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. favorites keeps the recency ordering but lifts the calling user's favorited shows to the top of each publication day; it requires an authenticated user session (401 for an API key or anonymous token) and falls back to plain recency for a user with no favorited podcasts. Pass the same sort alongside a cursor when paginating.
Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.
Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.
Only episodes published after this date.
Only episodes published before this date.
Surrounding dialogue lines around each mention.
Episodes 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.
Opaque cursor from a previous response.
Only mentions spoken by a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder.
Only mentions spoken by a guest listed under this ANZSRC 2020 field of research (code, slug, or title).
Only mentions spoken by a guest whose standing is recognized this way.
Only mentions spoken by a guest at this seniority or above.
Only mentions spoken by a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too.
Only mentions spoken by a guest who still works in guest_occupation, a SOC 2018 occupation or group.
Only mentions spoken by a guest speaking within their field (the guest the other guest_ filters select, when given).
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.