Particle: List Company Podcast Recommendations

List podcasts a company could advertise on next, from its company slug or domain.

Tool ID: particle_list_company_podcast_recommendations

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

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_list_company_podcast_recommendations --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",
        "podcast": {
          "id": "id_123",
          "title": "VP of Engineering"
        },
        "score": 123
      }
    ],
    "has_more": true
  }
}

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

Input reference

Returns shows the company does NOT advertise on, ranked by how related they are to the shows it DOES — the buy-side prospect list. Each seed show counts by how much the company advertises there, so a list is anchored on its main venues. every show it has ever bought is excluded. Each row carries the podcast, a calibrated score in (0,1), a band (strong / moderate / weak), and with include=via the company’s own shows that led there. Companies with no podcast advertising get an empty page.

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	—	Company identifier — slug, domain, or canonical ID
`payload.include`	`array`	No	—	Optional response sections. Pass include=via to attach, for each recommendation, the company’s own shows that led to it — the venues to cite when explaining why the recommendation fits.
`payload.min_score`	`number`	No	—	Only recommendations at or above this score, applied within the 200 strongest recommendations the list holds. Omit (or 0) for every recommendation. The band field is the recommended way to filter by strength. Format: `double`. Minimum: 0. Maximum: 1.
`payload.language`	`string`	No	—	Only shows in this language (ISO 639-1 code, e.g. ‘en’, ‘es’. A region suffix such as ‘fr-CA’ is reduced to the language), applied within the 200 strongest recommendations the list holds.

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[].podcast`	`object`	Yes	—	—
`result.data.data[].podcast.best_rank`	`object`	No	—	—
`result.data.data[].podcast.best_rank.captured_at`	`string`	Yes	—	Format: `date-time`.
`result.data.data[].podcast.best_rank.category_slug`	`string`	No	—	—
`result.data.data[].podcast.best_rank.chart_type`	`"top_podcasts"`	Yes	—	Allowed: `top_podcasts`.
`result.data.data[].podcast.best_rank.country`	`string`	No	—	—
`result.data.data[].podcast.best_rank.rank`	`integer`	Yes	—	Format: `int64`.
`result.data.data[].podcast.best_rank.source`	`"apple" \| "spotify"`	Yes	—	Allowed: `apple`, `spotify`.
`result.data.data[].podcast.id`	`string`	Yes	—	Podcast ID
`result.data.data[].podcast.image_url`	`string`	No	—	Cover image URL
`result.data.data[].podcast.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[].podcast.publisher`	`object`	No	—	—
`result.data.data[].podcast.publisher.id`	`string`	Yes	—	Publisher ID
`result.data.data[].podcast.publisher.name`	`string`	Yes	—	Publisher name
`result.data.data[].podcast.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[].podcast.slug`	`string`	No	—	Human-readable slug identifier
`result.data.data[].podcast.title`	`string`	Yes	—	Podcast title
`result.data.data[].score`	`number`	Yes	—	Strength of the recommendation in (0,1): the seed shows’ relatedness to this one, compounded across the seeds that list it. For a guest the seeds are the shows that booked them, counted once per publisher. for a company the shows it already advertises on, weighted by how much it advertises there. Format: `double`.
`result.data.data[].via`	`array \| null`	No	—	The seed shows that led to this recommendation, strongest first: the person’s own shows, or the shows the company already buys. The reason to cite when explaining the fit.
`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).

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