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

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts?limit=24&include_previews=true&preview_limit=3"

200

{
  "data": [
    {
      "ad_count": 123,
      "episode_count": 123,
      "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>"
      },
      "preview_segments": [
        {
          "segment": {
            "duration_seconds": 123,
            "end_seconds": 123,
            "id": "<string>",
            "number": 123,
            "start_seconds": 123,
            "title": "<string>",
            "type": "<string>",
            "audio_url": "<string>",
            "description": "<string>",
            "end_line": 123,
            "episode": {
              "id": "<string>",
              "title": "<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>"
              },
              "published_at": "2023-11-07T05:31:56Z",
              "slug": "<string>"
            },
            "read_type": "<string>",
            "start_line": 123,
            "summary": "<string>"
          },
          "sponsors": [
            {
              "id": "<string>",
              "name": "<string>",
              "company": {
                "id": "<string>",
                "name": "<string>",
                "description": "<string>",
                "domain": "<string>",
                "image_mode": "AUTOMATIC",
                "image_url": "<string>",
                "slug": "<string>",
                "ticker": "<string>"
              }
            }
          ]
        }
      ],
      "sponsors": [
        {
          "ad_count": 123,
          "episode_count": 123,
          "sponsor": {
            "id": "<string>",
            "name": "<string>",
            "company": {
              "id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "domain": "<string>",
              "image_mode": "AUTOMATIC",
              "image_url": "<string>",
              "slug": "<string>",
              "ticker": "<string>"
            }
          },
          "last_seen_at": "2023-11-07T05:31:56Z"
        }
      ],
      "last_seen_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "sponsors": [
    {
      "ad_count": 123,
      "episode_count": 123,
      "sponsor": {
        "id": "<string>",
        "name": "<string>",
        "company": {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "domain": "<string>",
          "image_mode": "AUTOMATIC",
          "image_url": "<string>",
          "slug": "<string>",
          "ticker": "<string>"
        }
      },
      "last_seen_at": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>",
  "facets": {
    "podcast_count": 123,
    "podcasts": [
      {
        "ad_count": 123,
        "podcast": {
          "id": "<string>",
          "title": "<string>",
          "publisher": {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>"
          },
          "slug": "<string>"
        }
      }
    ],
    "publisher_count": 123,
    "publishers": [
      {
        "ad_count": 123,
        "podcast_count": 123,
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "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

limit · integer<int64> · default: 24

Results per page

Required range: 1 <= x <= 24

cursor · string

Opaque pagination cursor from a previous response

sponsor_id · string

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

podcast_id · string

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

publisher_id · string

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

include_facets · boolean

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

include_previews · boolean · default: true

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

preview_limit · integer<int64> · default: 3

Maximum previews per podcast when include_previews is enabled.

Required range: 1 <= x <= 8

since · string

Only include ads from episodes published on or after this ISO 8601 date or date-time

Example:

"2025-01-01T00:00:00Z"

until · string

Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day.

Example:

"2026-01-01"

Response

200

application/json

OK

data · object[] | null · required

Podcasts ranked by company ad count

Show child attributes

has_more · boolean · required

Whether more ranked podcasts exist

sponsors · object[] | null · required

Complete date-scoped sponsor roster for this company

Show child attributes

cursor · string

Pass to the next request for more podcasts

facets · object

Exhaustive Show and Network filter metadata, present only when requested on a cursorless request

Show child attributes