Podcast Transcripts
tier:standard

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. Useful for seeing exactly where and how an entity is discussed.

get/v1/podcasts/episodes/{id}/transcript/mentions

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/mentions
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Episode slug or ID

Query parameters

entity_idstring

Entity identifier (KGE ID or slug). When omitted, returns mentions for all entities.

context_linesinteger

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.

limitinteger

Results per page. When entity_id is set, paginates the mentions[] (windows) for that entity; otherwise paginates the top-level entities[].

cursorstring

Opaque pagination cursor from a previous response.

Response

OK

cursorstring

Pass to the next request to fetch the next page.

episode_idstring required

Parent episode ID

has_moreboolean required

When entity_id is set, true if more mention windows exist beyond this page; otherwise true if more entities exist.

Changes

No recorded changes to this operation across all 2 revisions of this API.