Companies
tier:premium

Get company advertising profile

Returns advertising intelligence for a specific company across the podcast ecosystem, including reach metrics and recent ad placements. Identify the company by slug (e.g., 'apple'), domain, or ID.

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

Request

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

sincestring

Only include ads from episodes published on or after this ISO 8601 date or date-time (e.g. 2025-01-01 or 2025-01-01T00:00:00Z)

Example:2025-01-01T00:00:00Z
untilstring

Only include ads from episodes published before this ISO 8601 date or date-time (e.g. 2026-01-01 or 2026-01-01T00:00:00Z)

Example:2026-01-01T00:00:00Z

Response

OK

company_idstring required

Company identifier (domain, slug, or encoded ID)

episode_reachinteger required

Number of distinct episodes with ads

podcast_reachinteger required

Number of distinct podcasts with ads

slugstring

Stable human-readable handle (the linked knowledge-graph slug, e.g. 'nvidia'), when known. Prefer it (or company_id) as a /v1/companies key.

total_adsinteger required

Total number of ads across all podcasts

Changes

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