Podcasts
tier:standard

List entity mentions in a podcast

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.

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

Path parameters

idstring required

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

entity_idstring

Entity slug (e.g., 'sam-altman', 'openai') or ID

company_idstring

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.

sincestring

Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

untilstring

Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

published_afterstring

Deprecated alias of since.

published_beforestring

Deprecated alias of until.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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