Get advertising timeseries
Returns time-bucketed ad placement counts for a sponsor or company, split into host-read and pre-recorded placements, plus range totals. Exactly one of sponsor_id or company_id is required; company_id aggregates across every sponsor alias linked to the company. Pass podcast_id or publisher_id to scope the counts to one show or network, matching the mentions timeseries so both series can be charted under the same scope. Counts use the same attribution as the sponsor podcasts and segments endpoints, so bucket sums agree with their ad_count values. Network promos are excluded.
Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Sponsor ID. Exactly one of sponsor_id or company_id is required.
Company ID, domain, or entity slug. Aggregates across every sponsor alias linked to the company.
Restrict to ad placements on one podcast, by slug or ID.
Restrict to ad placements on podcasts attributed to one publisher (network), by slug or ID.
Inclusive 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 Response
OK
Contiguous zero-filled buckets in ascending order
Distinct episodes those placements aired in
Distinct podcasts those placements aired on
Host-read placements in the range
Bucket width
day, week, month Placements not read by the host in the range
Ad placements 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, ads on this date up to the bound are still counted.
Start of the first bucket as a UTC date