{"uid":"cap_QtKu3ogcFJ-4JwqsHBQr6","slug":"particle-pro-get-entity-mentions-in-episode-transcript-e46c7ea2","name":"Particle Pro – Get Entity Mentions in Episode Transcript","description":"Get entity mentions in transcript. Finds all mentions of a specific entity within an episode's transcript and returns each mention with surrounding dialogue context.","url":"https://api.particle.pro/v1/podcasts/episodes/:id/transcript/mentions","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"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Episode slug or ID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page. When entity_id is set, paginates the mentions[] (windows) for that entity; otherwise paginates the top-level entities[]."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response."},"entity_id":{"type":"string","description":"Entity identifier (KGE ID or slug). When omitted, returns mentions for all entities."},"context_lines":{"type":"integer","format":"int64","description":"Lines of dialogue context returned on each side of every mention line. A single mention yields up to 2*context_lines+1 lines (clamped at transcript boundaries). Adjacent or overlapping windows merge into one chunk."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PgkRfyVCMPolpPez3kg9-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds all mentions of a specific entity within a podcast episode's transcript and returns each mention with surrounding dialogue context windows.","exampleAgentPrompt":"Show me every time Sam Altman was mentioned in the All-In episode with ID 'ep-2024-summit', and give me 3 lines of context around each mention.","exampleUseCases":[{"title":"Research guest pre-appearance mentions","prompt":"Find all the times Satya Nadella was mentioned in the Lex Fridman episode 'lex-412' before his actual interview segment starts — give me 5 lines of context around each mention so I can see what was said about him."},{"title":"Brand monitoring in podcast content","prompt":"Pull every mention of Nvidia in the episode 'all-in-ep-180' transcript, with 2 lines of dialogue on each side so I can see what they were discussing in context."},{"title":"Political figure tracking in media","prompt":"I want to see all the times Joe Biden came up in episode 'pivot-pod-sep23' — use entity ID 'joe-biden' and show me the surrounding conversation for each mention."}],"resultDescription":"Returns a paginated list of entity mentions found in the episode transcript. Each mention includes the matched dialogue line and a configurable window of surrounding lines (controlled by context_lines). When entity_id is not specified, returns top-level entities found with their mentions. Supports cursor-based pagination for navigating large result sets.","failureModes":["Episode ID not found — 404 if the slug or ID does not correspond to an existing episode","Entity ID not found — empty mentions array or 404 if the entity_id does not exist in the knowledge graph","Transcript unavailable — episode may not yet have a processed transcript","Invalid cursor — 400 if a malformed or expired pagination cursor is provided","Rate limiting or payment failure — 402 if x402 payment is not processed correctly for the $0.03 per-call fee"],"whenToPreferThis":"Use this endpoint when you need to find and read the specific parts of a podcast transcript where a known entity (person, company, etc.) is mentioned, along with conversational context. Prefer this over full transcript retrieval when you only care about a specific entity's mentions rather than the entire transcript. Best suited for media monitoring, research, and entity-focused transcript analysis workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:20.687Z","isFirstParty":false}