Skip to main content
GET
/
v1
/
podcasts
/
episodes
/
{id}
/
transcript
/
mentions
Get entity mentions in transcript
curl --request GET \
  --url https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/mentions \
  --header 'X-API-Key: <api-key>'
{
  "entities": [
    {
      "entity_id": "<string>",
      "entity_name": "<string>",
      "mention_variants": [
        "<string>"
      ],
      "mentions": [
        {
          "end_seconds": 123,
          "lines": [
            {
              "end_seconds": 123,
              "is_mention": true,
              "number": 123,
              "speaker": "<string>",
              "start_seconds": 123,
              "text": "<string>",
              "role": "<string>"
            }
          ],
          "start_seconds": 123
        }
      ],
      "total_mention_count": 123
    }
  ],
  "episode_id": "<string>"
}

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

Episode ID

Query Parameters

entity_id
string

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

context_lines
integer<int64>
default:2

Number of dialogue lines before and after each mention

Required range: 0 <= x <= 20

Response

OK

entities
object[] | null
required

Entity mention results. One per entity when entity_id is specified, multiple when showing all.

episode_id
string
required

Parent episode ID