Particle: Get Advertising Timeseries

Get time-bucketed podcast ad counts, host-read vs pre-recorded, for one sponsor_id or one company_id (exactly one is required).

Tool ID: particle_get_advertising_timeseries

Run this action

This action has conditional or dynamic inputs. A static example cannot describe these inputs reliably. Read the live contract before you execute this action:

deepline describe particle_get_advertising_timeseries --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "buckets": [
      {
        "count": 123,
        "host_read_count": 123,
        "pre_recorded_count": 123,
        "start": "example"
      }
    ],
    "distinct_episodes": 123,
    "distinct_podcasts": 123,
    "host_read_count": 123,
    "interval": "day",
    "pre_recorded_count": 123,
    "total_ads": 123
  }
}

Use deepline describe particle_get_advertising_timeseries --json for the latest machine-readable contract.

Input reference

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.

Name	Type	Required	Default	Details
`payload.sponsor_id`	`string`	No	—	Sponsor ID. Exactly one of sponsor_id or company_id is required.
`payload.company_id`	`string`	No	—	Company ID, domain, or entity slug. Aggregates across every sponsor alias linked to the company.
`payload.podcast_id`	`string`	No	—	Restrict to ad placements on one podcast, by slug or ID.
`payload.publisher_id`	`string`	No	—	Restrict to ad placements on podcasts attributed to one publisher (network), by slug or ID.
`payload.since`	`string`	No	—	Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time.
`payload.until`	`string`	No	—	End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now.
`payload.published_after`	`string`	No	—	Deprecated alias of since.
`payload.published_before`	`string`	No	—	Deprecated alias of until.
`payload.interval`	`"day" \| "week" \| "month"`	No	`"week"`	Bucket width. Weeks start on Monday and all buckets are UTC-aligned. Allowed: `day`, `week`, `month`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.buckets`	`array \| null`	Yes	—	Contiguous zero-filled buckets in ascending order
`result.data.buckets[].count`	`integer`	Yes	—	Ad placements in this bucket Format: `int64`.
`result.data.buckets[].host_read_count`	`integer`	Yes	—	Host-read placements in this bucket Format: `int64`.
`result.data.buckets[].pre_recorded_count`	`integer`	Yes	—	Placements not read by the host in this bucket Format: `int64`.
`result.data.buckets[].start`	`string`	Yes	—	Bucket start as a UTC date
`result.data.distinct_episodes`	`integer`	Yes	—	Distinct episodes those placements aired in Format: `int64`.
`result.data.distinct_podcasts`	`integer`	Yes	—	Distinct podcasts those placements aired on Format: `int64`.
`result.data.end`	`string`	No	—	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.
`result.data.host_read_count`	`integer`	Yes	—	Host-read placements in the range Format: `int64`.
`result.data.interval`	`"day" \| "week" \| "month"`	Yes	—	Bucket width Allowed: `day`, `week`, `month`.
`result.data.pre_recorded_count`	`integer`	Yes	—	Placements not read by the host in the range Format: `int64`.
`result.data.start`	`string`	No	—	Start of the first bucket as a UTC date
`result.data.total_ads`	`integer`	Yes	—	Ad placements matching the filters in the range Format: `int64`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

Example response

Input reference

Output reference

Deepline cost

Related documentation