Podcast Advertising
tier:premium

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.

get/v1/podcasts/advertising/timeseries

Request

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

Query parameters

sponsor_idstring

Sponsor ID. Exactly one of sponsor_id or company_id is required.

company_idstring

Company ID, domain, or entity slug. Aggregates across every sponsor alias linked to the company.

podcast_idstring

Restrict to ad placements on one podcast, by slug or ID.

publisher_idstring

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

sincestring

Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time.

untilstring

End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now.

published_afterstring

Deprecated alias of since.

published_beforestring

Deprecated alias of until.

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

Bucket width. Weeks start on Monday and all buckets are UTC-aligned.

Response

OK

distinct_episodesinteger required

Distinct episodes those placements aired in

distinct_podcastsinteger required

Distinct podcasts those placements aired on

endstring

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.

host_read_countinteger required

Host-read placements in the range

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

Bucket width

pre_recorded_countinteger required

Placements not read by the host in the range

startstring

Start of the first bucket as a UTC date

total_adsinteger required

Ad placements matching the filters in the range

Changes

No recorded changes to this operation across all 2 revisions of this API.