Particle: List Podcast Recommended Sponsors

List advertisers that run on a podcast’s related shows but not on it, as a sponsorship prospecting list, from its slug.

Tool ID: particle_list_podcast_recommended_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_podcast_recommended_sponsors',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_list_podcast_recommended_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": [
      {
        "band": "strong",
        "score": 123,
        "shared_show_count": 123,
        "sponsor": {
          "id": "id_123",
          "name": "Example"
        },
        "total_ads": 123
      }
    ],
    "has_more": true
  }
}

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

Input reference

Returns advertisers that run on the podcast’s related shows but not on this one, ranked by how related those venues are, how much the sponsor buys there, and how recently — a prospecting list for a show selling its own inventory (‘who buys shows like mine’), not a prediction. Each row carries the sponsor (with its linked company, the path to people to contact via GET /v1/companies/{id}/people), a score, a band, how many related shows run it, its ad count across them, the date of its most recent ad, and with include=via which shows. active_since keeps only sponsors still buying after a date. Related sets are precomputed (GET /v1/podcasts/{id}/related). A show whose set has not been computed yet gets an empty page. For who sponsors THIS show use GET /v1/podcasts/{id}/advertising. for a sponsor’s full footprint use GET /v1/podcasts/advertising/sponsors/{id}/podcasts.

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	—	Podcast slug (e.g., ‘all-in’), internal ID, or numeric iTunes ID
`payload.include`	`array`	No	—	Optional response sections. Pass include=via to attach, for each recommended sponsor, the related shows that run it (the peer set to cite in a pitch). Pass include=contacts to attach up to three people at the sponsor’s company most likely to own a sponsorship decision, with their role class and LinkedIn URL.
`payload.min_score`	`number`	No	—	Only recommendations with a score at or above this value. Omit (or 0) for every recommendation. The band field is the recommended way to filter by strength. Format: `double`. Minimum: 0. Maximum: 1.
`payload.active_since`	`string`	No	—	Only sponsors whose most recent ad across the related shows was published on or after this ISO 8601 date or date-time — the ‘still buying’ filter.
`payload.exclude_top_advertisers`	`integer`	No	—	Drop the N most active advertisers corpus-wide from the list. An advertiser is every sponsor record that resolves to the same company or name, ranked by summed lifetime ad count. The list is strongest beyond the largest programmatic advertisers, which every list already names. 50 removes the head, 200 keeps only the long tail. 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[].band`	`"strong" \| "moderate" \| "weak"`	Yes	—	Coarse class of the score. branch on this rather than on exact thresholds. Allowed: `strong`, `moderate`, `weak`.
`result.data.data[].company_contested`	`boolean`	No	—	Whether the company link is disputed: true when the recent majority is under 60%, when the declared domain does not map to a company, when a mapped domain is contradicted by an ad majority of 60% or more, and for every all-time fallback. A weak disagreement with a mapped domain is not contested. A contested company is the best available guess — it is still served, but contacts are withheld.
`result.data.data[].contacts`	`array \| null`	No	—	Up to three people at the sponsor’s company most likely to own a podcast sponsorship decision (marketing, partnerships, brand, media, communications, growth, then other executives), each with the role class and a LinkedIn URL when known. Present only with include=contacts, only when the sponsor resolves to a company, and never when company_contested is true.
`result.data.data[].contacts[].linkedin_url`	`string`	No	—	The person’s LinkedIn profile when known — an InMail path even without an email.
`result.data.data[].contacts[].person`	`object`	Yes	—	—
`result.data.data[].contacts[].person.description`	`string`	No	—	Short description (e.g. current role), when known.
`result.data.data[].contacts[].person.id`	`string`	Yes	—	Encoded Person identifier
`result.data.data[].contacts[].person.image_url`	`string`	No	—	Canonical headshot URL when one is known for the Person
`result.data.data[].contacts[].person.name`	`string`	Yes	—	Display name
`result.data.data[].contacts[].person.slug`	`string`	No	—	Stable human-readable handle (e.g. ‘satya-nadella’). Recommended canonical identifier on every Particle Pro person surface.
`result.data.data[].contacts[].role`	`"marketing" \| "brand" \| "partnerships" \| "media_advertising" \| "communications" \| "growth" \| "executive" \| "other"`	Yes	—	Contact role class derived from the title. contacts are ordered by how likely the class is to own a sponsorship decision. Allowed: `marketing`, `brand`, `partnerships`, `media_advertising`, `communications`, `growth`, `executive`, `other`.
`result.data.data[].contacts[].title`	`string`	No	—	Current title at the company, as recorded.
`result.data.data[].last_ad_at`	`string`	No	—	Publish date of the sponsor’s most recent ad across those shows. Format: `date-time`.
`result.data.data[].score`	`number`	Yes	—	Strength of the recommendation in (0,1): how related the shows that run this sponsor are, counted once per publisher, weighted by whether it is still buying there and how much (saturating after about twenty reads). Compounds across publishers. Format: `double`.
`result.data.data[].shared_show_count`	`integer`	Yes	—	How many of the show’s related shows run this sponsor. Format: `int64`.
`result.data.data[].sponsor`	`object`	Yes	—	—
`result.data.data[].sponsor.company`	`object`	No	—	—
`result.data.data[].sponsor.company.description`	`string`	No	—	Short company description, when known.
`result.data.data[].sponsor.company.domain`	`string`	No	—	Primary website domain (e.g. ‘nvidia.com’), when known.
`result.data.data[].sponsor.company.id`	`string`	Yes	—	Company identifier (domain, slug, or encoded ID)
`result.data.data[].sponsor.company.image_url`	`string`	No	—	Company logo or image URL
`result.data.data[].sponsor.company.name`	`string`	Yes	—	Company name
`result.data.data[].sponsor.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[].sponsor.company.ticker`	`string`	No	—	Primary stock ticker symbol, when listed.
`result.data.data[].sponsor.id`	`string`	Yes	—	Unique identifier
`result.data.data[].sponsor.name`	`string`	Yes	—	Sponsor name
`result.data.data[].total_ads`	`integer`	Yes	—	The sponsor’s ad reads summed over those related shows (network promos excluded). Format: `int64`.
`result.data.data[].via`	`array \| null`	No	—	The related shows that run this sponsor, most related first (at most three) — the peer set to cite in a pitch.
`result.data.data[].via[].best_rank`	`object`	No	—	—
`result.data.data[].via[].best_rank.captured_at`	`string`	Yes	—	Format: `date-time`.
`result.data.data[].via[].best_rank.category_slug`	`string`	No	—	—
`result.data.data[].via[].best_rank.chart_type`	`"top_podcasts"`	Yes	—	Allowed: `top_podcasts`.
`result.data.data[].via[].best_rank.country`	`string`	No	—	—
`result.data.data[].via[].best_rank.rank`	`integer`	Yes	—	Format: `int64`.
`result.data.data[].via[].best_rank.source`	`"apple" \| "spotify"`	Yes	—	Allowed: `apple`, `spotify`.
`result.data.data[].via[].id`	`string`	Yes	—	Podcast ID
`result.data.data[].via[].image_url`	`string`	No	—	Cover image URL
`result.data.data[].via[].popularity`	`number`	No	—	Global popularity percentile in (0,1], a cume_dist ranking over all currently-charting podcasts (Apple Podcasts charts). Higher is more popular. Omitted when the podcast is not currently charting, on endpoints that build this resource from a projection rather than the full podcast row, and in episode stream, feed and archive payloads, which are stored and replayed: read it live from the podcast endpoints. Format: `double`.
`result.data.data[].via[].publisher`	`object`	No	—	—
`result.data.data[].via[].publisher.id`	`string`	Yes	—	Publisher ID
`result.data.data[].via[].publisher.name`	`string`	Yes	—	Publisher name
`result.data.data[].via[].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[].via[].slug`	`string`	No	—	Human-readable slug identifier
`result.data.data[].via[].title`	`string`	Yes	—	Podcast title
`result.data.has_more`	`boolean`	Yes	—	Whether more results exist
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

This output schema is too large for an inline display. Read the complete live contract with deepline describe particle_list_podcast_recommended_sponsors --json.

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