Skip to main content

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.

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 advertising/get_company_ad_presence; for per-podcast use advertising/get_podcast_sponsors.

​
Inputs

FieldTypeRequiredDefaultDescription
metricstringnoad_countRanking metric. One of: ad_count, podcast_reach, episode_reach.
sincestringno—Only count ads created on or after this ISO 8601 date.
untilstringno—Only count ads created on or before this ISO 8601 date.
company_slugstringno—Constrain to one sponsor’s brand family by company slug, domain, or ID.
limitinteger (1–50)no10Sponsors per page.
cursorstringno—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. Older results paginate with cursor=<value>. 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
---

More results available — pass cursor=r.4gfFC7 to paginate.
The value in parentheses is the company_id for that sponsor — feed it into advertising/get_company_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: advertising/sponsor_leaderboard {
  "metric": "podcast_reach",
  "since": "2025-01-01",
  "limit": 25
}