{"uid":"cap_7wOzP1kRXwxv_CPC1KB4D","slug":"particle-pro-list-company-podcast-advertising-placements-643e974e","name":"Particle Pro - List Company Podcast Advertising Placements","description":"List company podcast advertising placements. Returns a newest-first, keyset-paginated feed of physical podcast ad placements with a known episode publication time, attributed to a company, with episode and podcast context plus every company","url":"https://api.particle.pro/v1/companies/:id/podcast/advertising/placements","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 previous response"},"podcast_id":{"type":"string","description":"Optional podcast ID, slug, or Apple/iTunes collection ID"},"sponsor_id":{"type":"string","description":"Optional sponsor ID. Selects placements attributed to this sponsor while preserving co-sponsors in the response."}}}},"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_gWMEjP7Y8QgLYvPPkukno","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 a newest-first, paginated feed of podcast ad placements attributed to a specific company, with episode, podcast, and sponsor context.","exampleAgentPrompt":"Pull the 20 most recent podcast ad placements for Squarespace from Particle Pro, filtering for episodes published since January 1 2024, and show me the episode title, podcast name, and any co-sponsors.","exampleUseCases":[{"title":"Competitive ad placement research","prompt":"Show me the last 50 podcast ad placements by Hubspot — I want to know which shows they've been sponsoring and whether they're running ads alongside other sponsors."},{"title":"Brand podcast spend timeline","prompt":"Get me all podcast advertising placements for Nike going back to 2023 — list them newest first so I can see how their podcast ad strategy has changed over time."},{"title":"Podcast-specific sponsor audit","prompt":"Which companies have been advertising on the 'My First Million' podcast? Filter specifically for placements from the last 6 months and include any co-sponsors on each episode."}],"resultDescription":"A newest-first, keyset-paginated list of podcast ad placement records for the specified company, each including episode publication time, episode and podcast metadata (title, ID, etc.), the attributed company, and all co-sponsors present in that placement. Includes a pagination cursor for retrieving subsequent pages.","failureModes":["Unknown company slug or domain returns a 404 or empty result set","Invalid cursor value causes a pagination error","Date range filters with malformed ISO 8601 strings return a 400 validation error","Requesting a nonexistent podcast_id returns an empty placement list","Rate limiting or payment failure (x402) blocks the request","Very new or obscure companies may return zero placements"],"whenToPreferThis":"Use this endpoint when you need structured, attributed podcast advertising data for a specific company — including episode context, co-sponsor relationships, and time-bound filtering. It is ideal for competitive intelligence, brand tracking, and sponsorship research workflows. Prefer this over generic web search or podcast directory APIs when you need machine-readable, paginated advertising placement data with sponsor attribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:22.887Z","isFirstParty":false}