{"slug":"api-particle-pro-v1-podcasts-mentions-8e8b57","title":"Search podcast dialogue for entity mentions","host":"api.particle.pro","method":"GET","resource":"https://api.particle.pro/v1/podcasts/mentions","category":"company","description":"Search podcast dialogue for entity mentions. Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency.","price_listed":0.04,"price_asked":0.04,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":151,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"language":"fr","since":"2024-01-01","until":"2024-06-01"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"company_id":{"description":"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).","type":"string"},"context_lines":{"description":"Surrounding dialogue lines around each mention.","format":"int64","type":"integer"},"cursor":{"description":"Opaque cursor from a previous response.","type":"string"},"entity_id":{"description":"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.","type":"string"},"episode_id":{"description":"Restrict to mentions inside one episode by slug or ID (cross-corpus result still surfaces a single episode group).","type":"string"},"include_ads":{"description":"Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.","type":"boolean"},"language":{"description":"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'.","type":"string"},"limit":{"description":"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.","format":"int64","type":"integer"},"podcast_id":{"description":"Restrict to mentions inside one podcast.","type":"string"},"publisher_id":{"description":"Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.","type":"string"},"role":{"description":"Constrain how the entity participates: guest, host, panelist, correspondent, or mention.","enum":["guest","host","panelist","correspondent","mention"],"type":"string"},"since":{"description":"Only episodes published after this date.","type":"string"},"sort":{"description":"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.","enum":["recency","popularity","favorites"],"type":"string"},"until":{"description":"Only episodes published before this date.","type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.04,"price_match":true,"latency_ms":151,"error":null}],"description_full":"Search podcast dialogue for entity mentions. Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency.","last_updated":"2026-09-20T01:03:10.845Z","schemes":["exact"]}