particle_podcast_get_sponsor_leaderboard

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.

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.

For per-company analytics use particle_company_get_podcast_ad_presence; for per-podcast use particle_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):

## 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 as company_slug (which accepts knowledge-graph slug, domain, or canonical ID interchangeably) for a deeper view of any sponsor on the leaderboard.

Example

Agent calls: particle_podcast_get_sponsor_leaderboard {
  "metric": "podcast_reach",
  "since": "2025-01-01",
  "limit": 25
}

REST equivalent: GET /v1/advertising/leaderboard.
Per-company analytics: particle_company_get_podcast_ad_presence.
Per-podcast analytics: particle_podcast_get_sponsors.

Get started

Tools

particle_podcast_get_sponsor_leaderboard

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related