Particle: List Sponsor Trends

List podcast sponsors whose ad volume is accelerating, comparing the trailing window (default 7 days) with the window before it.

Tool ID: particle_list_sponsor_trends

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_trends',
  {
    "limit": 25,
    "cursor": "cursor_123",
    "window_days": 7
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_list_sponsor_trends --input '{
  "limit": 25,
  "cursor": "cursor_123",
  "window_days": 7
}' --json

Example response

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

{
  "data": {
    "data": [
      {
        "ad_count_delta": 123,
        "previous_ad_count": 123,
        "recent_ad_count": 123,
        "sponsor": {
          "ad_count": 123,
          "episode_reach": 123,
          "id": "id_123",
          "name": "Example",
          "podcast_reach": 123
        }
      }
    ],
    "has_more": true
  }
}

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

Input reference

Surfaces advertisers whose podcast ad volume is accelerating. Each row compares the sponsor’s ads aired in the trailing window (default 7 days) against the equal-length window immediately before it, ranked by the delta. Windowing follows episode publication dates, so rankings reflect when ads aired, not when they were ingested. Results may be cached for up to one hour.

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.window_days`	`integer`	No	`7`	Length in days of each comparison window. Sponsors are ranked by ads aired in the trailing window_days versus the equal-length window immediately before it. Format: `int64`. Minimum: 1. Maximum: 90.
`payload.min_podcast_reach`	`integer`	No	`3`	Only include sponsors whose in-window ads span at least this many distinct podcasts. Guards the ranking against a single show binge-publishing episodes of one sponsor. Format: `int64`. Minimum: 1. Maximum: 1000.

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_delta`	`integer`	Yes	—	recent_ad_count minus previous_ad_count — the ranking signal Format: `int64`.
`result.data.data[].last_ad_at`	`string`	No	—	Publication time of the sponsor’s most recent in-window ad Format: `date-time`.
`result.data.data[].previous_ad_count`	`integer`	Yes	—	Ads aired inside the equal-length window immediately before the trailing window Format: `int64`.
`result.data.data[].recent_ad_count`	`integer`	Yes	—	Ads aired inside the trailing window Format: `int64`.
`result.data.data[].sponsor`	`object`	Yes	—	—
`result.data.data[].sponsor.ad_count`	`integer`	Yes	—	Total number of ads (excluding network promos) Format: `int64`.
`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.episode_reach`	`integer`	Yes	—	Number of distinct episodes featuring the sponsor Format: `int64`.
`result.data.data[].sponsor.first_seen_at`	`string`	No	—	Earliest detected ad appearance Format: `date-time`.
`result.data.data[].sponsor.id`	`string`	Yes	—	Unique identifier
`result.data.data[].sponsor.last_seen_at`	`string`	No	—	Most recent ad appearance Format: `date-time`.
`result.data.data[].sponsor.name`	`string`	Yes	—	Sponsor name
`result.data.data[].sponsor.podcast_reach`	`integer`	Yes	—	Number of distinct podcasts the sponsor advertises on 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