Particle: List Sponsor Publishers

List the podcast publishers a sponsor advertises with, from a sponsor ID (from particle_list_sponsors).

Tool ID: particle_list_sponsor_publishers

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'particle_list_sponsor_publishers',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_list_sponsor_publishers --input '{
  "id": "id_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "ad_count": 123,
        "coverage_share": 123,
        "episode_reach": 123,
        "podcast_coverage": 123,
        "publisher": {
          "id": "id_123",
          "name": "Example"
        },
        "publisher_podcast_count": 123
      }
    ],
    "has_more": true
  }
}

Use deepline describe particle_list_sponsor_publishers --json for the latest machine-readable contract.

Input reference

Returns the podcast publishers a sponsor advertises across, ordered by podcast coverage (the count of distinct publisher podcasts where the sponsor appears). Surfaces the bundle-buy signature: a sponsor showing 60–100% coverage on multiple publishers is doing network buys, not per-show buys.

Name	Type	Required	Default	Details
`payload.limit`	`integer`	No	`25`	Results per page Format: `int64`. Minimum: 1. Maximum: 100.
`payload.cursor`	`string`	No	—	Opaque pagination cursor from previous response
`payload.id`	`string`	Yes	—	Sponsor ID, company ID, company domain, or company slug. When the value resolves to a company (not a specific sponsor), the response aggregates across every sponsor linked to that company — the canonical ‘where does this advertiser buy?’ view. When it resolves to a sponsor ID, the response is scoped to that single deduped sponsor.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.cursor`	`string`	No	—	Pass to next request for more results
`result.data.data`	`array`	Yes	—	List of results
`result.data.data[].ad_count`	`integer`	Yes	—	Ads from this sponsor on the publisher’s catalog Format: `int64`.
`result.data.data[].coverage_share`	`number`	Yes	—	podcast_coverage / publisher.total_podcasts (0..1). A sponsor with coverage_share >= 0.25 on a publisher is doing a network buy across the catalog. Format: `double`.
`result.data.data[].episode_reach`	`integer`	Yes	—	Distinct episodes featuring the sponsor on the publisher’s catalog Format: `int64`.
`result.data.data[].first_seen_at`	`string`	No	—	Earliest detected ad appearance Format: `date-time`.
`result.data.data[].last_seen_at`	`string`	No	—	Most recent ad appearance Format: `date-time`.
`result.data.data[].podcast_coverage`	`integer`	Yes	—	Distinct podcasts in the publisher where the sponsor appears Format: `int64`.
`result.data.data[].publisher`	`object`	Yes	—	—
`result.data.data[].publisher.id`	`string`	Yes	—	Publisher ID
`result.data.data[].publisher.name`	`string`	Yes	—	Publisher name
`result.data.data[].publisher.slug`	`string`	No	—	Human-readable slug identifier (e.g., ‘goalhanger’, ‘iheartpodcasts’). When present, accepted in place of the ID anywhere a publisher reference is taken in the API. Occasionally absent on publishers whose name doesn’t slugify (e.g., scripts not representable in ASCII URL slugs).
`result.data.data[].publisher_podcast_count`	`integer`	Yes	—	Total podcasts in the publisher’s catalog Format: `int64`.
`result.data.has_more`	`boolean`	Yes	—	Whether more results exist
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation