{"uid":"cap_fcnQyjKABHKgNyQO_KbBq","slug":"particle-pro-podcast-advertising-leaderboard-2488a1ec","name":"Particle Pro Podcast Advertising Leaderboard","description":"Get advertising leaderboard. Returns the top podcast advertising sponsors ranked by the specified metric, with optional time range and company filtering.","url":"https://api.particle.pro/v1/podcasts/advertising/leaderboard","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"since":{"type":"string","description":"Only include ads from episodes published on or after this ISO 8601 date or date-time (e.g. 2025-01-01 or 2025-01-01T00:00:00Z)"},"until":{"type":"string","description":"Only include ads from episodes published before this ISO 8601 date or date-time (e.g. 2026-01-01 or 2026-01-01T00:00:00Z)"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"metric":{"enum":["ad_count","podcast_reach","episode_reach"],"type":"string","description":"Metric to rank sponsors by"},"company_id":{"type":"string","description":"Filter by company ID, domain, or entity slug"},"publisher_id":{"type":"string","description":"Restrict the leaderboard to ads on podcasts attributed to this publisher (slug or ID)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TfyXVCHsFcLE8Rqrid6i5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top podcast advertising sponsors ranked by ad count, podcast reach, or episode reach, with optional time range and company/publisher filtering.","exampleAgentPrompt":"Show me the top 10 podcast advertising sponsors ranked by podcast reach from January 1, 2025 to June 30, 2025.","exampleUseCases":[{"title":"Top sponsors by ad volume in 2025","prompt":"Who are the top 20 podcast advertisers by number of ads placed so far in 2025? Show me the leaderboard starting from January 1, 2025."},{"title":"Competitor podcast advertising comparison","prompt":"I want to see which companies dominate podcast advertising by episode reach — can you pull the top 10 sponsors and filter it to show only ads from January 2025 through March 2025?"},{"title":"Publisher-specific sponsor leaderboard","prompt":"Which sponsors run the most podcast ads on a specific publisher's shows? I want a leaderboard ranked by ad count restricted to publisher ID 'nyt-audio' for the past year."}],"resultDescription":"A paginated, ranked list of companies/sponsors with their scores for the specified metric (ad_count, podcast_reach, or episode_reach), filtered by optional date range, company, or publisher. Includes an opaque pagination cursor for fetching subsequent pages.","failureModes":["Invalid metric enum value returns 400 error","Malformed ISO 8601 date in 'since' or 'until' causes 400 validation error","Unknown company_id or publisher_id returns empty results or 404","Expired or invalid pagination cursor returns error","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need a ranked leaderboard of podcast advertising sponsors across the entire ecosystem or filtered to a specific publisher or company, especially when ranking by reach or ad count over a defined time window. Prefer this over the company advertising profile endpoint when you need comparative rankings across multiple sponsors rather than deep intelligence on a single company.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:41:05.721Z","isFirstParty":false}