GET /v1/podcasts/mentions returns every line of dialogue across the catalog where a resolved entity is named, grouped by episode and ordered by recency. Each item in data is one episode plus all of its mention windows. A mention window is a contiguous range of dialogue around a name, with is_mention flagged on the lines that actually contain it.
This is the right endpoint when the answer doesn’t depend on the wording of your query — only on who is being named.
Available to MCP agents as
particle_podcast_find_mentions.When to use Mentions vs Search
Examples
Response
data. windows[] is ordered by time within the episode. mention_count is the number of lines that triggered is_mention=true. mention_variants is the distinct strings observed for the entity (e.g., ["Sam Altman", "Altman"]) — useful for UI labels.
If an episode mentions the entity more than 50 times, the page surfaces the first 50 windows and sets truncated: true on the episode. The next-page cursor still advances to a different episode — windows never split across pages.
Filters
Pagination
Standardlimit (1–100, default 25) + opaque cursor. The unit of pagination is the episode — a single episode never splits across pages, so a page may return fewer total dialogue lines than another with the same limit. Pass the cursor from the previous response back as ?cursor=… for the next page.
Related
- Episode search — find dialogue by topic or phrase.
- Transcripts → mentions in one episode — every entity mentioned in one episode (the inverse view).
- Podcast → mentions rollup — episode-level salience aggregated across one podcast.