Podcast Episode Search
tier:standard

List an entity's mentions by podcast

Changed on

Returns the podcasts that mentioned a person, company, or entity in a window, each with its episode and mention line counts there and in the equal-length window just before it, labeled new, continuing, or dropped: which shows picked the subject up, which kept talking about it, and which went quiet, without paging the mentions themselves. The totals count every podcast, whatever the page or change filter, and the current window's match /v1/podcasts/mentions/timeseries for the same filters. Mentions inside ad reads are excluded unless include_ads=true. The window defaults to the last 7 days and may span 90; the response echoes its exact bounds, so pass start and end back as since and until when paging. The newest day fills in as episodes are processed, usually within a day, so end the window earlier for a settled comparison. interval adds each podcast's buckets over the current window. Requires entity_id or company_id.

For the lines, call /v1/podcasts/mentions with the row's podcast_id and the same since and until. For the total over time, use /v1/podcasts/mentions/timeseries.

get/v1/podcasts/mentions/by-podcast

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/mentions/by-podcast
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

entity_idstring

Entity slug (e.g., 'sam-altman') or ID. Required when company_id is not set.

company_idstring

Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity.

publisher_idstring

Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.

role'guest' | 'host' | 'panelist' | 'correspondent' | 'mention'

Constrain how the entity participates: guest, host, panelist, correspondent, or mention.

include_adsboolean

Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.

languagestring

Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.

Example:fr
guest_occupationstring

Only mentions spoken by a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder.

guest_fieldstring

Only mentions spoken by a guest listed under this ANZSRC 2020 field of research (code, slug, or title).

guest_standing'established' | 'self_described' | 'unverified'

Only mentions spoken by a guest whose standing is recognized this way.

guest_seniority'professional' | 'senior' | 'distinguished'

Only mentions spoken by a guest at this seniority or above.

guest_capacity'researcher' | 'licensed_professional' | 'practitioner' | 'executive_founder' | 'public_official' | 'journalist_analyst' | 'creator_entertainer' | 'athlete_coach' | 'clergy' | 'firsthand' | 'layperson'

Only mentions spoken by a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too.

guest_practicingboolean

Only mentions spoken by a guest who still works in guest_occupation, a SOC 2018 occupation or group.

guest_in_fieldboolean

Only mentions spoken by a guest speaking within their field (the guest the other guest_ filters select, when given).

sincestring

Start of the current window, included. Defaults to 7 days before until; the window may span at most 90 days. The previous window is as long and ends where this one starts.

Example:2026-10-01
untilstring

End of the current window: a bare date includes that whole UTC day, a date-time is excluded. Defaults to now.

Example:2026-10-08
change'new' | 'continuing' | 'dropped'

Only podcasts that are new to the subject (mentioned it in the current window only), continuing (both windows), or dropped (the previous window only).

sort'mentions' | 'rising' | 'falling' | 'popularity'

mentions (the default) puts the most current-window mention lines first, then, for podcasts that dropped the subject, the most previous-window ones. rising and falling order by mention_count_delta, largest gain or largest loss first. popularity orders by the podcast's global popularity percentile, non-charting podcasts last. Pass the same sort alongside a cursor when paging.

interval'day' | 'week' | 'month'

Add each podcast's counts per bucket of this width over the current window.

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

Response

OK

continuing_podcastsinteger required

Podcasts that mentioned it in both windows

cursorstring

Pass to next request for more results

distinct_podcastsinteger required

Podcasts with at least one of those episodes

dropped_podcastsinteger required

Podcasts that mentioned it in the previous window but not the current one

endstring date-time required

End of the current window, excluded.

has_moreboolean required

Whether more results exist

new_podcastsinteger required

Podcasts that mentioned the subject in the current window but not the previous one

previous_distinct_podcastsinteger required

Podcasts with at least one of those episodes

previous_startstring date-time required

Start of the previous window, included. The previous window is as long as the current one and ends where it starts.

previous_total_episodesinteger required

Episodes with at least one counted mention in the previous window

previous_total_mentionsinteger required

Counted mention lines across those episodes

startstring date-time required

Start of the current window, included. Pass it back as since, with end as until, to page or re-read the same windows.

total_episodesinteger required

Episodes with at least one counted mention in the current window, across every podcast

total_mentionsinteger required

Counted mention lines across those episodes

Changes