Companies
tier:premium

List company podcast advertising placements

Returns a newest-first, keyset-paginated feed of physical podcast ad placements with a known episode publication time, attributed to a company, with episode and podcast context plus every company-scoped sponsor attribution.

get/v1/companies/{id}/podcast/advertising/placements

Request

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

Path parameters

idstring required

Company slug (e.g. 'apple'), domain (e.g. 'apple.com'), or ID

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

sponsor_idstring

Optional sponsor ID. Selects placements attributed to this sponsor while preserving co-sponsors in the response.

podcast_idstring

Optional podcast ID, slug, or Apple/iTunes collection 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 before this ISO 8601 date-time. A bare date includes that whole UTC day.

Example:2026-01-01

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.