Get mention timeseries
Returns time-bucketed counts of episodes mentioning an entity, plus per-bucket mention line counts and range totals — the aggregate twin of /v1/podcasts/mentions. For windows the search can fully enumerate, bucket counts match what it returns: mentions inside ad reads are excluded by default (pass include_ads=true to count them), so use this for mention trend charts instead of paging the search once per period. Buckets are UTC-aligned, zero-filled, and Monday-aligned for weeks. Requires entity_id or company_id. Omitting published_after aggregates all time. Ranges are capped at 1000 buckets.
For appearance trends by speaker role across episode-level filters (language, duration, keyword_search) use /v1/podcasts/episodes/timeseries instead; its role=mention counts include ad reads.
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 inside one podcast.
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.
Only episodes published on or after this date. Omit to aggregate all time.
"2026-01-01"
Only episodes published on or before this date. Defaults to now.
"2026-06-01"
Bucket width.
day, week, month Response
OK
Contiguous zero-filled buckets in ascending order
Distinct podcasts those episodes aired on
Bucket width
day, week, month Episodes with at least one counted mention in the range
Counted mention lines across those episodes
The resolved company, when company_id was used
UTC date of the range's exclusive upper bound. When the bound falls inside a day, such as the default of now, mentions on this date up to the bound are still counted.
The resolved entity the counts are for
Start of the first bucket as a UTC date