---
title: "List entity mentions in a podcast"
method: GET
path: "/v1/podcasts/{id}/mentions"
tags: ["Podcasts", "tier:standard"]
---

# List entity mentions in a podcast

`GET /v1/podcasts/{id}/mentions`

## Request

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

Returns episodes where a specific entity appears within a podcast, ordered by most recent. Each result includes the episode, salience score, occurrence count, and speaker roles. Requires entity_id or company_id.

## Path parameters

- `id` string, required: Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

## Query parameters

- `limit` integer: Results per page
- `cursor` string: Opaque pagination cursor from previous response
- `entity_id` string: Entity slug (e.g., 'sam-altman', 'openai') or ID
- `company_id` string: Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.
- `role` 'guest' | 'host' | 'panelist' | 'correspondent' | 'mention': Entity role filter. Constrains which episodes match.
- `since` string: Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)
- `until` string: Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)
- `published_after` string: Deprecated alias of since.
- `published_before` string: Deprecated alias of until.

## Response `200`

OK

- PagePodcastMention
  - `cursor` string: Pass to next request for more results
  - `data` PodcastMention[], nullable, required: List of results
    - `episode` EpisodeCompact, required
      - `clip_count` integer: Number of clips
      - `duration_seconds` number, double, required: Duration in seconds
      - `has_transcript` boolean, required: Whether a transcript is available
      - `id` string, required: Episode ID
      - `published_at` string, date-time: Publication date
      - `segment_count` integer: Number of segments
      - `slug` string: Human-readable slug identifier
      - `title` string, required: Episode title
      - `transcript_status` 'transcribed' | 'processing' | 'queued' | 'requestable' | 'unavailable', required: Where the episode stands on the way to a transcript; see Episode.transcript_status.
    - `occurrences` integer, required: Number of times the entity is mentioned in this episode
    - `salience` number, double, required: Importance score for this entity within the episode. When salience metadata is available, this is a percentile rank in (0.0, 1.0) — 0.95 means more salient than 95% of other entities mentioned, and the top entity approaches but never reaches 1.0. A value of 0.0 indicates salience metadata was unavailable for this episode/entity (e.g. a speaker-only appearance with no mention row).
    - `speaker_roles` string[], nullable: Roles the entity holds as a speaker (e.g. HOST, GUEST)
  - `has_more` boolean, required: Whether more results exist

## Other responses

- `402`: Payment Required. Read error_code. payment_required is the x402 path: either a keyless request being challenged — pay $0.03 in USDC per request (requirements in the PAYMENT-REQUIRED header) or send a pp_ API key — or a supplied payment that failed settlement (details in the PAYMENT-RESPONSE header; retry the same signature before signing a new one). See https://docs.particle.pro/x402. Any other code means the credential was accepted but does not cover this request (a plan or session gate such as premium_required or paid_plan_confirmation_required); its resolve says how to obtain access, and no payment header is sent.
- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)