particle_podcast_get_ad_trends

In the podcast_advertising category, which is opt-in — callable by name on any connection, but only advertised on tools/list when selected via ?include=podcast_advertising. Premium tier: requires a plan with premium endpoints. See Tool sets & discovery.

Podcast advertising momentum, in two modes:

sponsor_trends (default): sponsors ramping up or pulling back — ranked by the ad-count delta between the trailing window_days and the equal-length window immediately before it. Surfaces new campaign launches and churned advertisers.
timeseries: one company’s ad volume over time (company_slug required) — per-day/week/month placement counts split host-read vs pre-recorded, plus range totals. Narrow with podcast_slug or publisher_slug to chart that volume on one show or across one network’s catalog. The charting companion to particle_company_get_podcast_ad_presence.

For a static who’s-biggest ranking use particle_podcast_get_sponsor_leaderboard.

Inputs

Field	Type	Required	Default	Description
`mode`	string	no	`sponsor_trends`	What to return: `sponsor_trends` or `timeseries`.
`company_slug`	string	timeseries mode	—	Company slug, domain, or ID. Aggregates across every sponsor alias linked to the company.
`podcast_slug`	string	no	—	Timeseries mode: restrict the counts to ads on one podcast (slug, internal ID, or numeric iTunes ID).
`publisher_slug`	string	no	—	Timeseries mode: restrict the counts to ads on podcasts attributed to this publisher (slug or encoded ID).
`window_days`	integer (1–90)	no	7	Sponsor-trends mode: length of each comparison window.
`min_podcast_reach`	integer (1–1000)	no	3	Sponsor-trends mode: only include sponsors whose in-window ads span at least this many distinct podcasts.
`published_after` / `published_before`	string	no	all time / now	Timeseries mode: ISO 8601 range bounds.
`interval`	string	no	`week`	Timeseries mode: `day`, `week`, or `month`.
`limit`	integer (1–50)	no	10	Sponsor-trends mode: rows per page.
`cursor`	string	no	—	Sponsor-trends mode: opaque pagination cursor.

Output

In sponsor_trends mode: ## Sponsor trends (N) with one bullet per sponsor, formatted **Name** (company-slug) — +12 ads (19 vs 7 prior), 6 podcasts, last ad YYYY-MM-DD. The delta is the ranking signal; in-window metrics, not lifetime. In timeseries mode: ## Advertising timeseries — per <interval> with **Range:**, **Total ads:**, **Read mix:**, and **Reach:** rows, then a Bucket | Ads | Host-read | Pre-recorded table of contiguous zero-filled buckets.

Example

Agent calls: particle_podcast_get_ad_trends {
  "mode": "timeseries",
  "company_slug": "nvidia.com",
  "interval": "month",
  "published_after": "2026-01-01"
}

REST equivalents: GET /v1/podcasts/advertising/sponsors/trends (sponsor_trends), GET /v1/podcasts/advertising/timeseries (timeseries).
Company ad footprint: particle_company_get_podcast_ad_presence.

Get started

Tools

particle_podcast_get_ad_trends

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related