# Particle Pro – List Podcasts Carrying Company Advertising

> Particle Pro – List Podcasts Carrying Company Advertising is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns podcasts ranked by ad count that have carried advertising for a specific company, with sponsor filters, per-podcast sponsor breakdowns, preview segments, and cursor pagination.

## Facts

- Endpoint: GET https://api.particle.pro/v1/companies/:id/podcast/advertising/podcasts
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-list-podcasts-carrying-company-advertising-2ed4230d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KrkA6qixeSX7pbW5LUY6v

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability particle-pro-list-podcasts-carrying-company-advertising-2ed4230d
```

Example prompt: Show me all podcasts that have carried Apple ads — ranked by how many Apple ad placements each podcast has — including sponsor breakdowns and recent ad preview clips, starting from January 1, 2024.

## When to prefer this

Use this endpoint when you need to discover and rank podcasts by the volume of advertising a specific company has placed on them. It is the right choice for brand-level podcast ad audits, competitive media spend analysis, or building podcast targeting lists based on existing advertiser behavior. Prefer it over the placements endpoint when you want a podcast-centric view (aggregated by show) rather than individual ad placement records. Unlike the 'could advertise on next' endpoint, this shows where a company already has a proven ad presence.

## Known failure modes

- Unknown company ID/slug returns 404 or empty result set
- Invalid cursor string returns pagination error
- Date range with 'since' after 'until' returns validation error or empty results
- Requesting include_facets on a cursor-based (non-first) page is silently ignored
- sponsor_id or publisher_id filtering with no matching data returns empty podcast list
- Rate limiting or payment failure (x402) blocks the request

## How this service works

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.

## Output

A paginated list of podcasts that have carried advertising for the specified company, each entry ranked by the number of company-linked ad placements. Each podcast record includes a sponsor breakdown, optional recent ad segment previews, and metadata. Response may also include exhaustive Show and Network facet filters (when requested) and an opaque cursor for fetching the next page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Company slug (e.g. 'apple'), domain (e.g. 'apple.com'), or ID"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Results per page"
      },
      "since": {
       "type": "string",
       "description": "Only include ads from episodes published on or after this ISO 8601 date or date-time"
      },
      "until": {
       "type": "string",
       "description": "Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response"
      },
      "podcast_id": {
       "type": "string",
       "description": "Optional podcast ID, slug, or Apple/iTunes collection ID. Filters rich rows without narrowing facets."
      },
      "sponsor_id": {
       "type": "string",
       "description": "Optional sponsor ID. Keeps the company constraint while narrowing rows to this sponsor identity."
      },
      "publisher_id": {
       "type": "string",
       "description": "Optional publisher ID or slug. Filters rich rows without narrowing facets."
      },
      "preview_limit": {
       "type": "integer",
       "format": "int64",
       "description": "Maximum previews per podcast when include_previews is enabled."
      },
      "include_facets": {
       "type": "boolean",
       "description": "Include exhaustive lightweight Show and Network filter metadata. Honored only on cursorless requests."
      },
      "include_previews": {
       "type": "boolean",
       "description": "Include recent ad segment previews per podcast. Disable for count-only consumers to skip preview hydration."
      },
      "include_sponsors": {
       "type": "boolean",
       "description": "Include company-wide sponsor totals. Disable when loading podcast rows separately from filter m
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-list-podcasts-carrying-company-advertising-2ed4230d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.particle.pro](https://www.zero.xyz/host/api.particle.pro/llms.txt)