> ## 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_sponsor_leaderboard

> Ranked list of the most-active sponsors across the podcast catalog, by ad count, podcast reach, or episode reach.

<Note>
  In the **`podcast_advertising`** category, which is **opt-in** — it is callable by name on any connection, but only advertised on `tools/list` when selected via `?include=podcast_advertising`. See [Tool sets & discovery](/mcp/tool-sets).
</Note>

Ranked advertising leaderboards across the podcast catalog, in two modes:

* **`sponsors`** (default): the most-active sponsors by ad count (default), podcast reach, or episode reach. Optionally constrain to a time window, one company's brand family, or — with `publisher_slug` — one publisher's catalog (who buys the most across that publisher's shows).
* **`publishers`**: the sell side — publishers whose catalogs carry the most advertising, additionally rankable by `unique_sponsors` or `ads_per_active_podcast` (monetization density). Publisher slugs feed [`particle_podcast_get_publisher`](/mcp/tools/podcast_publishers/podcast-get-publisher).

For per-company analytics use [`particle_company_get_podcast_ad_presence`](/mcp/tools/podcast_advertising/company-get-podcast-ad-presence); for per-podcast use [`particle_podcast_get_sponsors`](/mcp/tools/podcast_advertising/podcast-get-sponsors).

All-time rankings — and two day-anchored windows: the trailing 7 days (`since` = UTC today−7d, no `until`) and the 7-day window ending 30 days ago (`since` = today−37d, `until` = today−30d) — are served from periodically refreshed snapshots. Other windowed and company-filtered rankings run live and may be cached for up to one hour.

## Inputs

| Field                 | Type             | Required | Default    | Description                                                                                                                                             |
| --------------------- | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`                | string           | no       | `sponsors` | Who to rank: `sponsors` or `publishers`.                                                                                                                |
| `metric`              | string           | no       | `ad_count` | Ranking metric. Sponsors mode: `ad_count`, `podcast_reach`, `episode_reach`. Publishers mode additionally: `unique_sponsors`, `ads_per_active_podcast`. |
| `since`               | string           | no       | —          | Only count ads from episodes published on or after this ISO 8601 date.                                                                                  |
| `until`               | string           | no       | —          | Only count ads from episodes published before this ISO 8601 date.                                                                                       |
| `company_slug`        | string           | no       | —          | Sponsors mode: constrain to one sponsor's brand family by company slug, domain, or ID.                                                                  |
| `publisher_slug`      | string           | no       | —          | Sponsors mode: restrict the ranking to ads on podcasts attributed to this publisher.                                                                    |
| `min_active_podcasts` | integer (1–1000) | no       | 5          | Publishers mode: only rank publishers with at least this many active podcasts.                                                                          |
| `limit`               | integer (1–50)   | no       | 10         | Sponsors per page.                                                                                                                                      |
| `cursor`              | string           | no       | —          | Opaque pagination cursor.                                                                                                                               |

## Output

A markdown document with `## Sponsor leaderboard by <metric> (N)` and a flat bullet list — one bullet per ranked sponsor, formatted `#<rank> <name> (<company_id>) — N ads, N podcasts, N episodes`. The parenthesized `company_id` appears only when the sponsor resolved to a known company. When more pages exist, a horizontal rule and a `**Cursor:** <value>` line are appended.

In `publishers` mode the document is `## Publisher advertising leaderboard by <metric> (N)` with bullets formatted `#<rank> <name> (publisher-slug) — N ads, N sponsors, N episodes, A/T active podcasts, X.X ads/podcast`.

Sample (`limit=3`, default `metric=ad_count`):

```markdown theme={"dark"}
## Sponsor leaderboard by ad_count (3)

- #1 Grainger (grainger.com) — 14880 ads, 655 podcasts, 10219 episodes
- #2 Mint Mobile (mintmobile.com) — 11637 ads, 912 podcasts, 10322 episodes
- #3 Shopify (shopify.com) — 11256 ads, 959 podcasts, 9854 episodes
---

**Cursor:** r.4gfFC7
```

The value in parentheses is the `company_id` for that sponsor — feed it into [`particle_company_get_podcast_ad_presence`](/mcp/tools/podcast_advertising/company-get-podcast-ad-presence) as `company_slug` (which accepts knowledge-graph slug, domain, or canonical ID interchangeably) for a deeper view of any sponsor on the leaderboard.

## Example

```text theme={"dark"}
Agent calls: particle_podcast_get_sponsor_leaderboard {
  "metric": "podcast_reach",
  "since": "2025-01-01",
  "limit": 25
}
```

## Related

* REST equivalent: [`GET /v1/advertising/leaderboard`](/podcasts/advertising).
* Per-company analytics: [`particle_company_get_podcast_ad_presence`](/mcp/tools/podcast_advertising/company-get-podcast-ad-presence).
* Per-podcast analytics: [`particle_podcast_get_sponsors`](/mcp/tools/podcast_advertising/podcast-get-sponsors).