Podcast Advertising
tier:premium

Get a sponsor

Returns a single advertising sponsor with activity metrics. The {id} path parameter accepts a sponsor ID, a company ID, a company domain, or a company slug.

get/v1/podcasts/advertising/sponsors/{id}

Request

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

Path parameters

idstring required

Sponsor ID, company ID, company domain, or company slug. When a company reference matches multiple sponsor aliases, the most-recently-active sponsor is returned.

Query parameters

sincestring

Only include ads from episodes published on or after this ISO 8601 date or date-time

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

Only include ads from episodes published before this ISO 8601 date or date-time

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

Response

OK

ad_countinteger required

Total number of ads (excluding network promos)

episode_reachinteger required

Number of distinct episodes featuring the sponsor

first_seen_atstring date-time

Earliest detected ad appearance

idstring required

Unique identifier

last_seen_atstring date-time

Most recent ad appearance

namestring required

Sponsor name

podcast_reachinteger required

Number of distinct podcasts the sponsor advertises on

Changes

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