{"uid":"cap_VFkDhRJCyU_3TpJama-6V","slug":"particle-pro-podcast-entity-mentions-search-640096bc","name":"Particle Pro Podcast Entity Mentions Search","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.","url":"https://api.particle.pro/v1/podcasts/mentions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"role":{"enum":["guest","host","panelist","correspondent","mention"],"type":"string","description":"Constrain how the entity participates: guest, host, panelist, correspondent, or mention."},"sort":{"enum":["recency","popularity","favorites"],"type":"string","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."},"limit":{"type":"integer","format":"int64","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."},"since":{"type":"string","description":"Only episodes published after this date."},"until":{"type":"string","description":"Only episodes published before this date."},"cursor":{"type":"string","description":"Opaque cursor from a previous response."},"language":{"type":"string","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'."},"entity_id":{"type":"string","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."},"company_id":{"type":"string","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)."},"episode_id":{"type":"string","description":"Restrict to mentions inside one episode by slug or ID (cross-corpus result still surfaces a single episode group)."},"podcast_id":{"type":"string","description":"Restrict to mentions inside one podcast."},"guest_field":{"type":"string","description":"Only mentions spoken by a guest listed under this ANZSRC 2020 field of research (code, slug, or title)."},"include_ads":{"type":"boolean","description":"Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them."},"publisher_id":{"type":"string","description":"Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID."},"context_lines":{"type":"integer","format":"int64","description":"Surrounding dialogue lines around each mention."},"guest_capacity":{"enum":["researcher","licensed_professional","practitioner","executive_founder","public_official","journalist_analyst","creator_entertainer","athlete_coach","clergy","firsthand","layperson"],"type":"string","description":"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."},"guest_in_field":{"type":"boolean","description":"Only mentions spoken by a guest speaking within their field (the guest the other guest_ filters select, when given)."},"guest_standing":{"enum":["established","self_described","unverified"],"type":"string","description":"Only mentions spoken by a guest whose standing is recognized this way."},"guest_seniority":{"enum":["professional","senior","distinguished"],"type":"string","description":"Only mentions spoken by a guest at this seniority or above."},"guest_occupation":{"type":"string","description":"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."},"guest_practicing":{"type":"boolean","description":"Only mentions spoken by a guest who still works in guest_occupation, a SOC 2018 occupation or group."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xWUvHnkxkqFixKQyOP26a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search podcast dialogue for every line where a specific person or company is mentioned, grouped by episode and ordered by recency or popularity.","exampleAgentPrompt":"Can you search Particle Pro for every podcast episode that mentions Sam Altman, limit it to the last 30 days, sort by popularity, and return the first 25 episodes?","exampleUseCases":[{"title":"CEO media coverage tracker","prompt":"Find all podcast dialogue mentioning Jensen Huang from episodes published since January 1st 2025, sorted by popularity, up to 50 results — I want to see which big shows have been talking about him."},{"title":"Competitive brand monitoring","prompt":"Pull every podcast mention of Anthropic from the past 60 days in English-language podcasts, sorted by recency, limit 25 per page — I need the exact lines of dialogue where they're discussed."},{"title":"Guest appearance research","prompt":"Search for all podcast episodes where Marc Andreessen appears as a guest rather than just a mention, sorted by recency, give me up to 100 episodes — I want to track his recent media tour."}],"resultDescription":"A paginated list of episodes grouped by publication date, each containing the specific dialogue windows (lines of dialogue) where the queried entity is mentioned, along with episode metadata such as show name, publication date, and an opaque cursor for fetching the next page.","failureModes":["Unknown entity_id returns empty results or 404","Invalid cursor value returns 400 bad request","favorites sort without authenticated user session returns 401","limit outside 1-100 range returns 400 validation error","Unsupported language code returns empty results or 400","since/until dates in wrong format return 400","Rate limiting or quota exhaustion returns 429"],"whenToPreferThis":"Choose this endpoint when you need granular dialogue-level evidence of when and how a specific person or company was discussed across podcasts — not just episode titles or show-level metadata. It is ideal for media monitoring, PR research, competitive intelligence, and tracking how public figures are discussed over time. It outperforms generic podcast search when you need exact quote windows grouped by episode and sortable by popularity or recency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T00:44:29.184Z","isFirstParty":false,"canonicalSlug":"particle-pro-podcast-entity-mentions-search-640096bc"}