format | "summary" | "detail" | "compact" | no | "summary" | Response shape. See “Three response modes” above. |
person_slug | string | one of | — | Person slug from particle_person_resolve or particle_entity_resolve (e.g. "sam-altman"). Also accepts a bare entity slug for non-person entities like places. |
company_slug | string | one of | — | Company slug, domain, or canonical ID (e.g. "nvidia" or "nvidia.com"). Resolves to the company’s linked entity. |
episode_slug | string | yes for detail | — | One slug for single drill-in, or up to 10 comma-separated slugs for a multi-episode drill-in in one call. In summary mode, optional filter to one episode. |
podcast_slug | string | no | — | Restrict mentions to a single podcast by slug, ID, or numeric iTunes ID. |
role | enum | no | — | Constrain how the entity participates. One of: guest, host, panelist, correspondent, mention. |
language | string | no | — | 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. |
since | string | no | — | Only episodes published on or after this ISO 8601 date (e.g. 2025-01-01). |
until | string | no | — | Only episodes published on or before this ISO 8601 date. |
guest_occupation | string | no | — | Only mentions spoken by a guest listed under this occupation: a SOC 2018 or ISCO-08 code, slug or title from particle_expertise_resolve (e.g. "financial-and-investment-analysts"). |
guest_field | string | no | — | Only mentions spoken by a guest listed under this ANZSRC 2020 field of research: a code, slug or title from particle_expertise_resolve. |
guest_standing | string | no | — | Only mentions spoken by a guest whose standing is recognized this way: established (conferred by others), self_described, or unverified. |
guest_seniority | string | no | — | Only mentions spoken by a guest at this seniority or above: professional, senior, or distinguished. |
guest_capacity | string | no | — | Only mentions spoken by a guest who knows their field in this capacity: researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, or layperson. particle_expertise_resolve names the capacity an everyday word means (founders is executive_founder). |
guest_practicing | boolean | no | false | Only mentions spoken by a guest who still works in guest_occupation, which must be a detailed SOC 2018 occupation. |
guest_in_field | boolean | no | false | Only mentions spoken by a guest speaking within their own field (the guest the other guest_ filters select, when given). |
speaker_statement_characteristics | object | no | — | Keep only lines said a certain way: an object of axes (sentiment, certainty, specificity, temporal_orientation), each an array of its labels, e.g. {"certainty": ["confident"], "temporal_orientation": ["future"]}. Labels on one axis match any of them; axes combine with AND. Put the topic in semantic_search, never the tone. Every mention line carries labels the filter accepts. With the guest_ filters, only the selected guests’ mention lines count. See Filtering by characteristics. |
context_lines | integer (1–20) | no | 2 | Surrounding dialogue lines around each mention. Detail mode only — ignored in summary and compact. |
limit | integer (1–50) | no | 10 | Episodes per page. Summary and compact modes only. |
cursor | string | no | — | Opaque pagination cursor. Summary and compact modes only. |