Get episode timeseries
Returns time-bucketed counts of episodes matching the same filters as GET /v1/podcasts/episodes, plus range totals. Use it for appearance, publication, or keyword trend charts instead of paging the episode list or search once per period. keyword_search counts episodes whose transcripts match (exact counts, no pagination floors) and adds per-bucket mention_count plus total_mentions. Buckets are UTC-aligned, zero-filled, and Monday-aligned for weeks. A published_after or published_before inside a bucket produces a partial first or last bucket labeled with the full bucket’s start date. Requires at least one of entity_id, person_id, company_id, podcast_id, or keyword_search. Omitting published_after aggregates all time. Ranges are capped at 1000 buckets.
Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID
Entity slug (e.g., 'elon-musk', 'openai') or ID. Counts episodes featuring this entity as a speaker or mentioned entity.
Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Counts episodes featuring this person as a speaker. Works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also count episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only counts.
Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.
Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id.
guest, host, panelist, correspondent, mention Keyword filter over episode transcript content. Double-quoted substrings must appear as exact phrases; unquoted terms must all appear in a transcript segment. Counts episodes with at least one matching segment and adds mention_count fields to the response. Combines with the other filters.
500Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time.
End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now.
Bucket width. Weeks start on Monday and all buckets are UTC-aligned.
day, week, month ISO 639-1 language code filter
Only count episodes with completed transcripts
Only count episodes that have reached the terminal ingestion milestone
Minimum episode duration in seconds
x >= 0Maximum episode duration in seconds
x >= 0Response
OK
Contiguous zero-filled buckets in ascending order
Distinct podcasts those episodes belong to
Bucket width
day, week, month Distinct episodes matching the filters in the range
UTC date of the range's exclusive upper bound. When the bound falls inside a day, such as the default of now, episodes on this date up to the bound are still counted.
Start of the first bucket as a UTC date
Transcript segments matching keyword_search across the range. Present only when keyword_search is set.