Get a sponsor

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

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

cURL

cURL

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

200

{
  "ad_count": 123,
  "episode_reach": 123,
  "id": "<string>",
  "name": "<string>",
  "podcast_reach": 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"
}

Authorizations

ApiKeyHeaderBearerAuth

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 most-recently-active sponsor 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

200

application/json

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

Show child attributes

first_seen_at · string<date-time>

Earliest detected ad appearance

last_seen_at · string<date-time>

Most recent ad appearance