Tool ID:
particle_list_company_advertising_podcastsRun this action
Use the TypeScript SDK for one call. Usectx.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_advertising_podcasts',
{
"id": "id_123"
},
);
console.log(result.toolResponse.raw);
CLI
deepline tools execute particle_list_company_advertising_podcasts --input '{
"id": "id_123"
}' --json
Example response
The static output schema lacks the details for a reliable example. Usedeepline describe particle_list_company_advertising_podcasts --json for the complete live contract.
Input reference
Returns podcasts ranked by exact company-linked ad count, with company-wide sponsor filters, per-podcast sponsor breakdowns, recent preview segments, and cursor pagination.| Name | Type | Required | Default | Details |
|---|---|---|---|---|
payload.id | string | Yes | — | Company slug (e.g. ‘apple’), domain (e.g. ‘apple.com’), or ID |
payload.limit | integer | No | 24 | Results per page Format: int64. Minimum: 1. Maximum: 24. |
payload.cursor | string | No | — | Opaque pagination cursor from a previous response |
payload.sponsor_id | string | No | — | Optional sponsor ID. Keeps the company constraint while narrowing rows to this sponsor identity. |
payload.podcast_id | string | No | — | Optional podcast ID, slug, or Apple/iTunes collection ID. Filters rich rows without narrowing facets. |
payload.publisher_id | string | No | — | Optional publisher ID or slug. Filters rich rows without narrowing facets. |
payload.include_facets | boolean | No | — | Include exhaustive lightweight Show and Network filter metadata. Honored only on cursorless requests. |
payload.include_sponsors | boolean | No | true | Include company-wide sponsor totals. Disable when loading podcast rows separately from filter metadata. per-podcast sponsors and previews are unchanged. |
payload.include_previews | boolean | No | true | Include recent ad segment previews per podcast. Disable for count-only consumers to skip preview hydration. |
payload.preview_limit | integer | No | 3 | Maximum previews per podcast when include_previews is enabled. Format: int64. Minimum: 1. Maximum: 8. |
payload.since | string | No | — | Only include ads from episodes published on or after this ISO 8601 date or date-time |
payload.until | string | No | — | Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day. |
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 the next request for more podcasts |
result.data.data | array | Yes | — | Podcasts ranked by company ad count |
result.data.data[].ad_count | integer | Yes | — | Exact company-linked ad count on this podcast in the requested scope Format: int64. |
result.data.data[].episode_count | integer | Yes | — | Exact distinct episode count on this podcast in the requested scope Format: int64. |
result.data.data[].last_seen_at | string | No | — | Publication time of the company’s most recent ad on this podcast Format: date-time. |
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[].preview_segments | array | null | Yes | — | Recent company-attributed ad segments from this podcast, bounded by the requested preview limit |
result.data.data[].preview_segments[].segment | object | Yes | — | — |
result.data.data[].preview_segments[].segment.audio_url | string | No | — | Direct audio URL for this segment |
result.data.data[].preview_segments[].segment.description | string | No | — | AI-generated segment description |
result.data.data[].preview_segments[].segment.duration_seconds | number | Yes | — | Segment duration Format: double. |
result.data.data[].preview_segments[].segment.end_line | integer | No | — | Last transcript line covered by this segment (1-indexed, inclusive). Omitted for episodes segmented before line ranges were recorded. Format: int64. |
result.data.data[].preview_segments[].segment.end_seconds | number | Yes | — | End time within the episode — when the segment’s last spoken line ends. Where start_line/end_line are present, segments partition the transcript’s lines rather than tiling the wall-clock timeline, and the interval between this and the next segment’s start_seconds contains no transcribed speech (typically under a second, occasionally minutes of music or silence). Segments without a recorded line range were produced by an earlier segmenter and a small share of them do leave transcript lines See the live schema for the complete constraint. |
result.data.data[].preview_segments[].segment.episode | object | No | — | — |
result.data.data[].preview_segments[].segment.episode.id | string | Yes | — | Episode ID |
result.data.data[].preview_segments[].segment.episode.podcast | object | No | — | — |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank | object | No | — | — |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.captured_at | string | Yes | — | Format: date-time. |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.category_slug | string | No | — | — |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.chart_type | "top_podcasts" | Yes | — | Allowed: top_podcasts. |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.country | string | No | — | — |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.rank | integer | Yes | — | Format: int64. |
result.data.data[].preview_segments[].segment.episode.podcast.best_rank.source | "apple" | "spotify" | Yes | — | Allowed: apple, spotify. |
result.data.data[].preview_segments[].segment.episode.podcast.id | string | Yes | — | Podcast ID |
result.data.data[].preview_segments[].segment.episode.podcast.image_url | string | No | — | Cover image URL |
result.data.data[].preview_segments[].segment.episode.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[].preview_segments[].segment.episode.podcast.publisher | object | No | — | — |
result.data.data[].preview_segments[].segment.episode.podcast.publisher.id | string | Yes | — | Publisher ID |
result.data.data[].preview_segments[].segment.episode.podcast.publisher.name | string | Yes | — | Publisher name |
result.data.data[].preview_segments[].segment.episode.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[].preview_segments[].segment.episode.podcast.slug | string | No | — | Human-readable slug identifier |
result.data.data[].preview_segments[].segment.episode.podcast.title | string | Yes | — | Podcast title |
result.data.data[].preview_segments[].segment.episode.published_at | string | No | — | Publication date Format: date-time. |
This output schema is too large for an inline display. Read the complete live contract with
deepline describe particle_list_company_advertising_podcasts --json.Deepline cost
- Pricing model:
fixed(per call). - Estimated Deepline credits:
0per pricing unit. - Provider-native pricing may still exist outside Deepline credit billing.