Podcast Advertising
tier:premium

Get advertising leaderboard

Returns the top podcast advertising sponsors ranked by the specified metric, with optional time range and company filtering. 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) — reflect periodically refreshed snapshots; other time-windowed and company-filtered results may be cached for up to one hour.

get/v1/podcasts/advertising/leaderboard

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/advertising/leaderboard
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

metric'ad_count' | 'podcast_reach' | 'episode_reach'

Metric to rank sponsors by

sincestring

Only include ads from episodes published on or after this ISO 8601 date or date-time (e.g. 2025-01-01 or 2025-01-01T00:00:00Z)

Example:2025-01-01T00:00:00Z
untilstring

Only include ads from episodes published before this ISO 8601 date or date-time (e.g. 2026-01-01 or 2026-01-01T00:00:00Z)

Example:2026-01-01T00:00:00Z
company_idstring

Filter by company ID, domain, or entity slug

publisher_idstring

Restrict the leaderboard to ads on podcasts attributed to this publisher (slug or ID)

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.