Podcast Advertising
tier:premium

List ad segments for a sponsor

Returns the individual ad segments attributed to a sponsor, ordered by episode publication date descending, optionally scoped to a single podcast. Results are consistent with the ad_count values from the sponsor podcasts endpoint. Network promos are excluded.

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

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/advertising/sponsors/{id}/segments
  • 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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

podcast_idstring

Scope results to one podcast by slug, internal ID, or numeric iTunes ID

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

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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