curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/advertising/publishers/leaderboard?limit=25&metric=ad_count&min_active_podcasts=5"{
"data": [
{
"ad_count": 123,
"ads_per_active_podcast": 123,
"coverage": {
"active_coverage": 123,
"active_podcasts": 123,
"total_podcasts": 123
},
"episode_reach": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"rank": 123,
"unique_sponsors": 123
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get publisher advertising leaderboard
Ranks podcast publishers by an advertising activity metric across their entire catalog. ads_per_active_podcast is the monetization-density metric — small sub-networks (e.g. ‘iHeartPodcasts and The Volume’, ‘Dan Patrick Network’) typically rank far above broad catalogs on this dimension.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/advertising/publishers/leaderboard?limit=25&metric=ad_count&min_active_podcasts=5"{
"data": [
{
"ad_count": 123,
"ads_per_active_podcast": 123,
"coverage": {
"active_coverage": 123,
"active_podcasts": 123,
"total_podcasts": 123
},
"episode_reach": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"rank": 123,
"unique_sponsors": 123
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Metric to rank publishers by. ads_per_active_podcast surfaces monetization density (small sub-networks often outrank big catalogs). Ranking reflects an all-time MV-fresh snapshot; this endpoint does not currently support time-window filters.
ad_count, unique_sponsors, podcast_reach, episode_reach, ads_per_active_podcast Only rank publishers with at least this many active podcasts (catalog podcasts that have run at least one detected ad). Guards ads_per_active_podcast and the other density-style metrics against tiny catalogs dominating the leaderboard — single-show publishers can otherwise rank #1 on ads_per_active_podcast purely on noise.
1 <= x <= 1000Was this page helpful?