> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # List trending sponsors > 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. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/advertising/sponsors/trends openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/podcasts/advertising/sponsors/trends: get: tags: - Podcast Advertising - tier:premium summary: List trending sponsors description: >- 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. operationId: list-sponsor-trends parameters: - description: Results per page explode: false in: query name: limit schema: default: 25 description: Results per page format: int64 maximum: 100 minimum: 1 type: integer - description: Opaque pagination cursor from previous response explode: false in: query name: cursor schema: description: Opaque pagination cursor from previous response type: string - description: >- 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. explode: false in: query name: window_days schema: default: 7 description: >- 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 maximum: 90 minimum: 1 type: integer - description: >- 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. explode: false in: query name: min_podcast_reach schema: default: 3 description: >- 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 maximum: 1000 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/PageSponsorTrend' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/advertising/sponsors/trends?limit=25&window_days=7&min_podcast_reach=3" components: schemas: PageSponsorTrend: additionalProperties: false properties: cursor: description: Pass to next request for more results type: string data: description: List of results items: $ref: '#/components/schemas/SponsorTrend' type: - array - 'null' has_more: description: Whether more results exist type: boolean required: - data - has_more type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object SponsorTrend: additionalProperties: false properties: ad_count_delta: description: recent_ad_count minus previous_ad_count — the ranking signal format: int64 type: integer last_ad_at: description: Publication time of the sponsor's most recent in-window ad format: date-time type: string previous_ad_count: description: >- Ads aired inside the equal-length window immediately before the trailing window format: int64 type: integer recent_ad_count: description: Ads aired inside the trailing window format: int64 type: integer sponsor: $ref: '#/components/schemas/Sponsor' description: Sponsor with activity metrics scoped to the trailing window required: - sponsor - recent_ad_count - previous_ad_count - ad_count_delta type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object Sponsor: additionalProperties: false properties: ad_count: description: Total number of ads (excluding network promos) format: int64 type: integer company: $ref: '#/components/schemas/CompanyCompact' description: Linked company record episode_reach: description: Number of distinct episodes featuring the sponsor format: int64 type: integer first_seen_at: description: Earliest detected ad appearance format: date-time type: string id: description: Unique identifier type: string last_seen_at: description: Most recent ad appearance format: date-time type: string name: description: Sponsor name type: string podcast_reach: description: Number of distinct podcasts the sponsor advertises on format: int64 type: integer required: - id - name - ad_count - podcast_reach - episode_reach type: object CompanyCompact: additionalProperties: false properties: description: description: Short company description, when known. type: string domain: description: Primary website domain (e.g. 'nvidia.com'), when known. type: string id: description: Company identifier (domain, slug, or encoded ID) type: string image_url: description: Company logo or image URL type: string name: description: Company name type: string slug: description: >- 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. type: string ticker: description: Primary stock ticker symbol, when listed. type: string required: - id - name type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````