Skip to main content
GET
/
v1
/
podcasts
/
publishers
/
{id}
/
advertising
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/publishers/{id}/advertising"
{
  "ads_per_active_podcast": 123,
  "coverage": {
    "active_coverage": 123,
    "active_podcasts": 123,
    "total_podcasts": 123
  },
  "episode_reach": 123,
  "network_buyers_count": 123,
  "publisher": {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>"
  },
  "read_type_breakdown": {
    "host_read": 123,
    "pre_recorded": 123
  },
  "top_sponsors": [
    {
      "ad_count": 123,
      "episode_count": 123,
      "podcast_coverage": 123,
      "sponsor_name": "<string>",
      "company_id": "<string>"
    }
  ],
  "total_ads": 123,
  "unique_sponsors": 123
}

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

Podcast publisher slug (e.g., 'iheartpodcasts', 'bbc-radio-4') or ID

Response

OK

ads_per_active_podcast
number<double>
required

Mean ad count across podcasts that ran at least one ad — monetization density. Same metric the cross-publisher leaderboard ranks on.

coverage
object
required

Catalog size and how much of it carries ads.

episode_reach
integer<int64>
required

Distinct episodes with ads

network_buyers_count
integer<int64>
required

Sponsors hitting at least 3 podcasts and at least 25% of the publisher's catalog — the bundle-buy signal.

publisher
object
required

The publisher whose catalog is summarized.

read_type_breakdown
object
required

Distribution of ad read types

top_sponsors
object[] | null
required

Most frequent sponsors across the catalog

total_ads
integer<int64>
required

Total ads detected across the catalog (excludes network promos)

unique_sponsors
integer<int64>
required

Distinct sponsors across the catalog