particle_podcast_get_sponsor_leaderboard

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

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 list of the most-active sponsors across the podcast catalog, by ad count (default), podcast reach, or episode reach. Optionally constrain to a time window or to one company’s brand family.

For per-company analytics use particle_company_get_podcast_ad_presence; for per-podcast use particle_podcast_get_sponsors.

Inputs

Field	Type	Required	Default	Description
metric	string	no	ad_count	Ranking metric. One of: ad_count, podcast_reach, episode_reach.
since	string	no	—	Only count ads created on or after this ISO 8601 date.
until	string	no	—	Only count ads created on or before this ISO 8601 date.
company_slug	string	no	—	Constrain to one sponsor’s brand family by company slug, domain, or ID.
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.

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
}

Related

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