> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/episodes/{id}/transcript/mentions openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/podcasts/episodes/{id}/transcript/mentions: get: tags: - Podcast Transcripts - tier:standard summary: Get entity mentions in transcript description: >- 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. operationId: get-episode-entity-mentions parameters: - description: Episode slug or ID in: path name: id required: true schema: description: Episode slug or ID type: string - description: >- Entity identifier (KGE ID or slug). When omitted, returns mentions for all entities. explode: false in: query name: entity_id schema: description: >- Entity identifier (KGE ID or slug). When omitted, returns mentions for all entities. type: string - 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. explode: false in: query name: context_lines schema: default: 2 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. format: int64 maximum: 20 minimum: 0 type: integer - description: >- Results per page. When entity_id is set, paginates the mentions[] (windows) for that entity; otherwise paginates the top-level entities[]. explode: false in: query name: limit schema: default: 25 description: >- Results per page. When entity_id is set, paginates the mentions[] (windows) for that entity; otherwise paginates the top-level entities[]. format: int64 maximum: 100 minimum: 1 type: integer - description: Opaque pagination cursor from a previous response. explode: false in: query name: cursor schema: description: Opaque pagination cursor from a previous response. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/EntityMentionsResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/mentions?context_lines=2&limit=25" components: schemas: EntityMentionsResponse: additionalProperties: false properties: cursor: description: Pass to the next request to fetch the next page. type: string entities: description: >- Entity mention results. One per entity when entity_id is specified, multiple (paginated) when showing all. items: $ref: '#/components/schemas/EntityMentionsForEntity' type: - array - 'null' episode_id: description: Parent episode ID type: string has_more: description: >- When entity_id is set, true if more mention windows exist beyond this page; otherwise true if more entities exist. type: boolean required: - episode_id - entities - has_more type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object EntityMentionsForEntity: additionalProperties: false properties: entity: $ref: '#/components/schemas/EntityCompact' description: The knowledge graph entity mention_variants: description: Distinct mention strings matched (e.g., ["Donald Trump", "Trump"]). items: type: string type: - array - 'null' mentions: description: >- Context windows. Each window contains up to 2*context_lines+1 lines around a mention; nearby windows merge into a single window, so multiple is_mention=true lines may appear in one entry. items: $ref: '#/components/schemas/EntityMention' type: - array - 'null' total_mention_count: description: >- Unfiltered total: number of dialogue lines containing at least one mention of this entity in the episode. Equals the sum of is_mention=true over the un-paginated mentions[]; independent of which page is requested. format: int64 type: integer required: - entity - total_mention_count - mention_variants - mentions type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object EntityCompact: additionalProperties: false properties: company: $ref: '#/components/schemas/EntityCompany' description: Linked company record, if this entity is a known company description: description: Short description type: string id: description: Entity ID type: string image_url: description: Entity image URL type: string name: description: Entity name type: string person: $ref: '#/components/schemas/EntityPerson' description: Linked person record, if this entity is a known person slug: description: Human-readable slug identifier type: string type: $ref: '#/components/schemas/EntityType' description: Category. Omitted when the entity falls outside the supported set. wikipedia_url: description: Wikipedia URL type: string required: - id - slug - name type: object EntityMention: additionalProperties: false properties: end_seconds: description: End time of the last line in seconds format: double type: number lines: description: Dialogue lines in this context window items: $ref: '#/components/schemas/EntityMentionLine' type: - array - 'null' start_seconds: description: Start time of the first line in seconds format: double type: number required: - lines - start_seconds - end_seconds type: object EntityCompany: additionalProperties: false properties: domain: description: Company website domain type: string id: description: Company identifier type: string ticker: description: Primary stock ticker symbol type: string required: - id type: object EntityPerson: additionalProperties: false properties: company: description: Current company name type: string id: description: Person identifier type: string image_url: description: Person headshot URL type: string title: description: Current role title type: string required: - id type: object EntityType: additionalProperties: false properties: name: description: Human-friendly display label (e.g. 'Company'). type: string slug: description: >- Stable identifier, safe to pass to the type query parameter (e.g. 'company'). type: string required: - slug - name type: object EntityMentionLine: additionalProperties: false properties: end_seconds: description: End time in seconds format: double type: number is_mention: description: Whether this line contains a mention of the target entity type: boolean matched_terms: description: >- Mention variants that occur in this line, longest-first, for clients to highlight. Set only on lines with is_mention=true. Each term is spelled as the variant was recorded; a multi-word variant ("Jason Stark") matches case-insensitively, so locate it case-insensitively, while a single-token variant matches the line's text exactly — "US" is reported for "US" but never for "us", so acronyms and short names don't highlight their common-word homographs. Whole-token matches only: a variant never matches inside a longer word. Only the longest term is reported at any position, so terms never overlap. items: type: string type: - array - 'null' number: description: Line number (1-indexed) format: int64 type: integer role: description: Speaker role (HOST, GUEST, etc.) type: string speaker: description: Speaker name or ID type: string start_seconds: description: Start time in seconds format: double type: number text: description: Spoken text type: string required: - number - speaker - start_seconds - end_seconds - text - is_mention type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````