Get podcast advertising profile

Returns advertising intelligence for a specific podcast, including aggregate stats, read type breakdown, and top sponsors. Identify the podcast by slug (e.g., ‘all-in’) or ID.

GET /v1/podcasts/{id}/advertising

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/{id}/advertising"

200

{
  "avg_ads_per_episode": 123,
  "episodes_with_ads": 123,
  "podcast_id": "<string>",
  "read_type_breakdown": {
    "host_read": 123,
    "pre_recorded": 123
  },
  "top_sponsors": [
    {
      "ad_count": 123,
      "episode_count": 123,
      "sponsor_name": "<string>",
      "company_id": "<string>",
      "slug": "<string>"
    }
  ],
  "total_ads": 123,
  "unique_sponsors": 123,
  "podcast_slug": "<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 slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

Response

200

application/json

OK

avg_ads_per_episode · number<double> · required

Average ads per episode

episodes_with_ads · integer<int64> · required

Number of episodes containing ads

podcast_id · string · required

Podcast identifier

read_type_breakdown · object · required

Distribution of ad read types

Show child attributes

top_sponsors · object[] | null · required

Most frequent sponsors

Show child attributes

total_ads · integer<int64> · required

Total number of ads detected

unique_sponsors · integer<int64> · required

Number of distinct sponsors

podcast_slug · string

Human-readable slug (when available)