Particle: List Publisher Advertising Sponsors

List the sponsors advertising across a publisher’s podcasts, from its publisher slug.

Tool ID: particle_list_publisher_advertising_sponsors

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_publisher_advertising_sponsors',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_list_publisher_advertising_sponsors --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,
        "id": "id_123",
        "name": "Example",
        "podcast_coverage": 123
      }
    ],
    "has_more": true
  }
}

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

Input reference

Returns a paginated list of sponsors active across the publisher’s catalog. Each entry includes the bundle-buy signal — podcast_coverage (distinct podcasts in the catalog where the sponsor appears) and coverage_share (the same as a 0..1 fraction of the publisher’s catalog). Sort by podcast_coverage and combine with min_podcast_coverage to surface network buyers.

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.q`	`string`	No	—	Search by name (case-insensitive partial match) Maximum length: 200.
`payload.id`	`string`	Yes	—	Podcast publisher slug (e.g., ‘iheartpodcasts’, ‘bbc-radio-4’) or ID
`payload.sort`	`"ad_count" \| "podcast_coverage" \| "episode_reach"`	No	`"ad_count"`	Sort order. ad_count ranks by ad volume on the publisher’s catalog. podcast_coverage surfaces network buyers (sponsors hitting many shows). episode_reach prioritizes broad episode-level exposure. Allowed: `ad_count`, `podcast_coverage`, `episode_reach`.
`payload.min_podcast_coverage`	`integer`	No	—	Only return sponsors that appear on at least this many distinct podcasts in the publisher’s catalog. Use to filter for bundle/network buyers. Format: `int64`. Minimum: 0. Maximum: 500.

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	—	Total ads from this sponsor on this publisher’s catalog Format: `int64`.
`result.data.data[].company`	`object`	No	—	—
`result.data.data[].company.description`	`string`	No	—	Short company description, when known.
`result.data.data[].company.domain`	`string`	No	—	Primary website domain (e.g. ‘nvidia.com’), when known.
`result.data.data[].company.id`	`string`	Yes	—	Company identifier (domain, slug, or encoded ID)
`result.data.data[].company.image_url`	`string`	No	—	Company logo or image URL
`result.data.data[].company.name`	`string`	Yes	—	Company name
`result.data.data[].company.slug`	`string`	No	—	Stable human-readable handle (the linked knowledge-graph slug, e.g. ‘nvidia’), when known. Companies have no slug of their own. prefer this for display and pass it (or id) to /v1/companies.
`result.data.data[].company.ticker`	`string`	No	—	Primary stock ticker symbol, when listed.
`result.data.data[].coverage_share`	`number`	Yes	—	podcast_coverage / publisher.total_podcasts (0..1). The bundle-buy signal: a sponsor with coverage_share >= 0.25 is doing a network buy across the publisher. Format: `double`.
`result.data.data[].episode_reach`	`integer`	Yes	—	Distinct episodes featuring this sponsor on this publisher’s catalog Format: `int64`.
`result.data.data[].first_seen_at`	`string`	No	—	Earliest detected ad appearance on this publisher’s catalog Format: `date-time`.
`result.data.data[].id`	`string`	Yes	—	Sponsor ID
`result.data.data[].last_seen_at`	`string`	No	—	Most recent ad appearance on this publisher’s catalog Format: `date-time`.
`result.data.data[].name`	`string`	Yes	—	Sponsor name
`result.data.data[].podcast_coverage`	`integer`	Yes	—	Distinct podcasts in the publisher where this sponsor appears 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