curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/mentions/by-podcast?sort=mentions&limit=25"{
"continuing_podcasts": 123,
"data": [
{
"change": "new",
"episode_count": 123,
"mention_count": 123,
"mention_count_delta": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"previous_episode_count": 123,
"previous_mention_count": 123,
"buckets": [
{
"episode_count": 123,
"mention_count": 123,
"podcast_count": 123,
"start": "<string>",
"partial": true
}
],
"last_mention_at": "2023-11-07T05:31:56Z"
}
],
"distinct_podcasts": 123,
"dropped_podcasts": 123,
"end": "2023-11-07T05:31:56Z",
"has_more": true,
"new_podcasts": 123,
"previous_distinct_podcasts": 123,
"previous_start": "2023-11-07T05:31:56Z",
"previous_total_episodes": 123,
"previous_total_mentions": 123,
"start": "2023-11-07T05:31:56Z",
"total_episodes": 123,
"total_mentions": 123,
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"cursor": "<string>",
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
}
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}List an entity's mentions by podcast
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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/mentions/by-podcast?sort=mentions&limit=25"{
"continuing_podcasts": 123,
"data": [
{
"change": "new",
"episode_count": 123,
"mention_count": 123,
"mention_count_delta": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"previous_episode_count": 123,
"previous_mention_count": 123,
"buckets": [
{
"episode_count": 123,
"mention_count": 123,
"podcast_count": 123,
"start": "<string>",
"partial": true
}
],
"last_mention_at": "2023-11-07T05:31:56Z"
}
],
"distinct_podcasts": 123,
"dropped_podcasts": 123,
"end": "2023-11-07T05:31:56Z",
"has_more": true,
"new_podcasts": 123,
"previous_distinct_podcasts": 123,
"previous_start": "2023-11-07T05:31:56Z",
"previous_total_episodes": 123,
"previous_total_mentions": 123,
"start": "2023-11-07T05:31:56Z",
"total_episodes": 123,
"total_mentions": 123,
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"cursor": "<string>",
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
}
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Entity slug (e.g., 'sam-altman') or ID. Required when company_id is not set.
Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity.
Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.
Constrain how the entity participates: guest, host, panelist, correspondent, or mention.
guest, host, panelist, correspondent, mention Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.
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'.
"fr"
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.
200Only mentions spoken by a guest listed under this ANZSRC 2020 field of research (code, slug, or title).
200Only mentions spoken by a guest whose standing is recognized this way.
established, self_described, unverified Only mentions spoken by a guest at this seniority or above.
professional, senior, distinguished 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.
researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, layperson Only mentions spoken by a guest who still works in guest_occupation, a SOC 2018 occupation or group.
Only mentions spoken by a guest speaking within their field (the guest the other guest_ filters select, when given).
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.
"2026-10-01"
End of the current window: a bare date includes that whole UTC day, a date-time is excluded. Defaults to now.
"2026-10-08"
Only podcasts that are new to the subject (mentioned it in the current window only), continuing (both windows), or dropped (the previous window only).
new, continuing, dropped 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.
mentions, rising, falling, popularity Add each podcast's counts per bucket of this width over the current window.
day, week, month Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Response
OK
Podcasts that mentioned it in both windows
List of results
Show child attributes
Show child attributes
Podcasts with at least one of those episodes
Podcasts that mentioned it in the previous window but not the current one
End of the current window, excluded.
Whether more results exist
Podcasts that mentioned the subject in the current window but not the previous one
Podcasts with at least one of those episodes
Start of the previous window, included. The previous window is as long as the current one and ends where it starts.
Episodes with at least one counted mention in the previous window
Counted mention lines across those episodes
Start of the current window, included. Pass it back as since, with end as until, to page or re-read the same windows.
Episodes with at least one counted mention in the current window, across every podcast
Counted mention lines across those episodes
The resolved company, when company_id was used
Show child attributes
Show child attributes
Pass to next request for more results
The resolved entity the counts are for
Show child attributes
Show child attributes
Was this page helpful?