Skip to main content
GET
Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

X-API-Key
string
header
required

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

Path Parameters

id
string
required

Sponsor ID, company ID, company domain, or company slug. When a company reference matches multiple sponsor aliases, the company's primary sponsor (the one carrying most of its ads) is returned.

Query Parameters

since
string

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

Example:

"2025-01-01T00:00:00Z"

until
string

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

Example:

"2026-01-01T00:00:00Z"

Response

OK

ad_count
integer<int64>
required

Total number of ads (excluding network promos)

episode_reach
integer<int64>
required

Number of distinct episodes featuring the sponsor

id
string
required

Unique identifier

name
string
required

Sponsor name

podcast_reach
integer<int64>
required

Number of distinct podcasts the sponsor advertises on

company
object

Linked company record

first_seen_at
string<date-time>

Earliest detected ad appearance

last_seen_at
string<date-time>

Most recent ad appearance