{"uid":"cap_KrkA6qixeSX7pbW5LUY6v","slug":"particle-pro-list-podcasts-carrying-company-advertising-2ed4230d","name":"Particle Pro – List Podcasts Carrying Company Advertising","description":"List podcasts carrying company advertising. Returns podcasts ranked by exact company-linked ad count, with company-wide sponsor filters, per-podcast sponsor breakdowns, recent preview segments, and cursor pagination.","url":"https://api.particle.pro/v1/companies/:id/podcast/advertising/podcasts","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"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Company slug (e.g. 'apple'), domain (e.g. 'apple.com'), or ID"}}},"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"},"until":{"type":"string","description":"Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response"},"podcast_id":{"type":"string","description":"Optional podcast ID, slug, or Apple/iTunes collection ID. Filters rich rows without narrowing facets."},"sponsor_id":{"type":"string","description":"Optional sponsor ID. Keeps the company constraint while narrowing rows to this sponsor identity."},"publisher_id":{"type":"string","description":"Optional publisher ID or slug. Filters rich rows without narrowing facets."},"preview_limit":{"type":"integer","format":"int64","description":"Maximum previews per podcast when include_previews is enabled."},"include_facets":{"type":"boolean","description":"Include exhaustive lightweight Show and Network filter metadata. Honored only on cursorless requests."},"include_previews":{"type":"boolean","description":"Include recent ad segment previews per podcast. Disable for count-only consumers to skip preview hydration."},"include_sponsors":{"type":"boolean","description":"Include company-wide sponsor totals. Disable when loading podcast rows separately from filter metadata; per-podcast sponsors and previews are unchanged."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V6G1ywexKbjOHvCBUMF10","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns podcasts ranked by ad count that have carried advertising for a specific company, with sponsor filters, per-podcast sponsor breakdowns, preview segments, and cursor pagination.","exampleAgentPrompt":"Show me all podcasts that have carried Apple ads — ranked by how many Apple ad placements each podcast has — including sponsor breakdowns and recent ad preview clips, starting from January 1, 2024.","exampleUseCases":[{"title":"Brand podcast ad audit","prompt":"Pull up every podcast that has run ads for apple.com since the start of 2024, ranked by total Apple ad count, and include the sponsor breakdowns and recent ad previews for each show."},{"title":"Competitive ad placement research","prompt":"I want to see which podcasts Nike has advertised on the most — give me the full ranked list with per-podcast sponsor breakdowns so I can understand their audio ad strategy."},{"title":"Publisher ad revenue attribution","prompt":"For the company with slug 'amazon', list all podcasts carrying their ads and filter results down to the 'wondery' publisher, including facets so I can see the full show and network breakdown."}],"resultDescription":"A paginated list of podcasts that have carried advertising for the specified company, each entry ranked by the number of company-linked ad placements. Each podcast record includes a sponsor breakdown, optional recent ad segment previews, and metadata. Response may also include exhaustive Show and Network facet filters (when requested) and an opaque cursor for fetching the next page.","failureModes":["Unknown company ID/slug returns 404 or empty result set","Invalid cursor string returns pagination error","Date range with 'since' after 'until' returns validation error or empty results","Requesting include_facets on a cursor-based (non-first) page is silently ignored","sponsor_id or publisher_id filtering with no matching data returns empty podcast list","Rate limiting or payment failure (x402) blocks the request"],"whenToPreferThis":"Use this endpoint when you need to discover and rank podcasts by the volume of advertising a specific company has placed on them. It is the right choice for brand-level podcast ad audits, competitive media spend analysis, or building podcast targeting lists based on existing advertiser behavior. Prefer it over the placements endpoint when you want a podcast-centric view (aggregated by show) rather than individual ad placement records. Unlike the 'could advertise on next' endpoint, this shows where a company already has a proven ad presence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:25.788Z","isFirstParty":false}