---
title: "List trending sponsors"
method: GET
path: "/v1/podcasts/advertising/sponsors/trends"
tags: ["Podcast Advertising", "tier:premium"]
---

# List trending sponsors

`GET /v1/podcasts/advertising/sponsors/trends`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/podcasts/advertising/sponsors/trends`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

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.

## Query parameters

- `limit` integer: Results per page
- `cursor` string: Opaque pagination cursor from previous response
- `window_days` integer: 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.
- `min_podcast_reach` integer: 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.

## Response `200`

OK

- PageSponsorTrend
  - `cursor` string: Pass to next request for more results
  - `data` SponsorTrend[], nullable, required: List of results
    - `ad_count_delta` integer, required: recent_ad_count minus previous_ad_count — the ranking signal
    - `last_ad_at` string, date-time: Publication time of the sponsor's most recent in-window ad
    - `previous_ad_count` integer, required: Ads aired inside the equal-length window immediately before the trailing window
    - `recent_ad_count` integer, required: Ads aired inside the trailing window
    - `sponsor` Sponsor, required
      - `ad_count` integer, required: Total number of ads (excluding network promos)
      - `company` CompanyCompact
        - `description` string: Short company description, when known.
        - `domain` string: Primary website domain (e.g. 'nvidia.com'), when known.
        - `id` string, required: Company identifier (domain, slug, or encoded ID)
        - `image_url` string: Company logo or image URL
        - `name` string, required: Company name
        - `slug` string: 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.
        - `ticker` string: Primary stock ticker symbol, when listed.
      - `episode_reach` integer, required: Number of distinct episodes featuring the sponsor
      - `first_seen_at` string, date-time: Earliest detected ad appearance
      - `id` string, required: Unique identifier
      - `last_seen_at` string, date-time: Most recent ad appearance
      - `name` string, required: Sponsor name
      - `podcast_reach` integer, required: Number of distinct podcasts the sponsor advertises on
  - `has_more` boolean, required: Whether more results exist

## Other responses

- `402`: Payment Required. Read error_code. payment_required is the x402 path: either a keyless request being challenged — pay $0.04 in USDC per request (requirements in the PAYMENT-REQUIRED header) or send a pp_ API key — or a supplied payment that failed settlement (details in the PAYMENT-RESPONSE header; retry the same signature before signing a new one). See https://docs.particle.pro/x402. Any other code means the credential was accepted but does not cover this request (a plan or session gate such as premium_required or paid_plan_confirmation_required); its resolve says how to obtain access, and no payment header is sent.
- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)