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

cURL

cURL

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

200

{
  "company_id": "<string>",
  "episode_reach": 123,
  "podcast_reach": 123,
  "read_type_breakdown": {
    "host_read": 123,
    "pre_recorded": 123
  },
  "recent_ads": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "duration_seconds": 123,
      "end_seconds": 123,
      "id": "<string>",
      "read_type": "<string>",
      "sponsor_name": "<string>",
      "start_seconds": 123,
      "company": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "domain": "<string>",
        "image_mode": "AUTOMATIC",
        "image_url": "<string>",
        "slug": "<string>",
        "ticker": "<string>"
      },
      "offer_description": "<string>",
      "placement_type": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "best_rank": {
          "captured_at": "2023-11-07T05:31:56Z",
          "chart_type": "top_podcasts",
          "rank": 123,
          "source": "apple",
          "category_slug": "<string>",
          "country": "<string>"
        },
        "image_url": "<string>",
        "popularity": 123,
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      },
      "product": "<string>",
      "sponsor_url": "<string>"
    }
  ],
  "total_ads": 123,
  "slug": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · required

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

Query Parameters

since · string

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"

until · string

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

200

application/json

OK

company_id · string · required

Company identifier (domain, slug, or encoded ID)

episode_reach · integer<int64> · required

Number of distinct episodes with ads

podcast_reach · integer<int64> · required

Number of distinct podcasts with ads

read_type_breakdown · object · required

Distribution of ad read types

Show child attributes

recent_ads · object[] | null · required

Most recent ad placements

Show child attributes

total_ads · integer<int64> · required

Total number of ads across all podcasts

slug · string

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