List sponsors for a publisher

Returns a paginated list of sponsors active across the publisher’s catalog. Each entry includes the bundle-buy signal — podcast_coverage (distinct podcasts in the catalog where the sponsor appears) and coverage_share (the same as a 0..1 fraction of the publisher’s catalog). Sort by podcast_coverage and combine with min_podcast_coverage to surface network buyers.

GET /v1/podcasts/publishers/{id}/advertising/sponsors

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/publishers/{id}/advertising/sponsors?limit=25&sort=ad_count"

200

{
  "data": [
    {
      "ad_count": 123,
      "coverage_share": 123,
      "episode_reach": 123,
      "id": "<string>",
      "name": "<string>",
      "podcast_coverage": 123,
      "company": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "domain": "<string>",
        "image_mode": "AUTOMATIC",
        "image_url": "<string>",
        "slug": "<string>",
        "ticker": "<string>"
      },
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

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

Query Parameters

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

q · string

Search by name (case-insensitive partial match)

Maximum string length: 200

Example:

"Apple"

sort · enum<string> · default: ad_count

Sort order. ad_count ranks by ad volume on the publisher's catalog; podcast_coverage surfaces network buyers (sponsors hitting many shows); episode_reach prioritizes broad episode-level exposure.

Available options: ad_count, podcast_coverage, episode_reach

min_podcast_coverage · integer<int64>

Only return sponsors that appear on at least this many distinct podcasts in the publisher's catalog. Use to filter for bundle/network buyers.

Required range: 0 <= x <= 500

Response

200

application/json

OK

data · object[] | null · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results