Companies
tier:premium

List podcasts carrying company advertising

Returns podcasts ranked by exact company-linked ad count, with company-wide sponsor filters, per-podcast sponsor breakdowns, recent preview segments, and cursor pagination.

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

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts
  • 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 a previous response

sponsor_idstring

Optional sponsor ID. Keeps the company constraint while narrowing rows to this sponsor identity.

podcast_idstring

Optional podcast ID, slug, or Apple/iTunes collection ID. Filters rich rows without narrowing facets.

publisher_idstring

Optional publisher ID or slug. Filters rich rows without narrowing facets.

include_facetsboolean

Include exhaustive lightweight Show and Network filter metadata. Honored only on cursorless requests.

include_sponsorsboolean

Include company-wide sponsor totals. Disable when loading podcast rows separately from filter metadata; per-podcast sponsors and previews are unchanged.

include_previewsboolean

Include recent ad segment previews per podcast. Disable for count-only consumers to skip preview hydration.

preview_limitinteger

Maximum previews per podcast when include_previews is enabled.

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 the next request for more podcasts

has_moreboolean required

Whether more ranked podcasts exist

Changes

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