> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_podcast_get_ad_trends

> Podcast advertising momentum — sponsors ramping up or pulling back, and one company's ad volume over time.

<Note>
  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](/mcp/tool-sets).
</Note>

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`](/mcp/tools/podcast_advertising/company-get-podcast-ad-presence).

For a static who's-biggest ranking use [`particle_podcast_get_sponsor_leaderboard`](/mcp/tools/podcast_advertising/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

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

## Related

* REST equivalents: [`GET /v1/podcasts/advertising/sponsors/trends`](/podcasts/advertising) (`sponsor_trends`), [`GET /v1/podcasts/advertising/timeseries`](/podcasts/advertising) (`timeseries`).
* Company ad footprint: [`particle_company_get_podcast_ad_presence`](/mcp/tools/podcast_advertising/company-get-podcast-ad-presence).