{"uid":"cap_U5DOxTj3fKhJ420RltdFc","slug":"particle-pro-list-ad-segments-for-sponsor-58b74a4f","name":"Particle Pro – List Ad Segments for Sponsor","description":"List ad segments for a sponsor. Returns the individual ad segments attributed to a sponsor, ordered by episode publication date descending, optionally scoped to a single podcast.","url":"https://api.particle.pro/v1/podcasts/advertising/sponsors/:id/segments","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":"Sponsor ID, company ID, company domain, or company slug"}}},"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 from episodes published before this ISO 8601 date or date-time"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"podcast_id":{"type":"string","description":"Scope results to one podcast by slug, internal ID, or numeric iTunes ID"}}}},"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_qN1gLe36DvPuuC4j3Eg0H","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 individual podcast ad segments attributed to a specific sponsor, ordered by episode publication date descending, with optional filtering by podcast and date range.","exampleAgentPrompt":"Show me all the individual podcast ad segments attributed to HubSpot, scoped to the 'My First Million' podcast, for episodes published since January 1, 2024.","exampleUseCases":[{"title":"Brand ad history research","prompt":"Pull all the individual podcast ad segments that Squarespace has appeared in since the start of 2023 — give me a newest-first list so I can see how their podcasting strategy has evolved."},{"title":"Competitor ad tracking on specific show","prompt":"I want to see every ad segment that Shopify has run on the Acquired podcast — scope it to that show only and show me the most recent episodes first."},{"title":"Campaign recency check","prompt":"Check when Notion last had a podcast ad segment — pull their most recent 10 ad appearances so I can see if they're still actively running podcast ads right now."}],"resultDescription":"A paginated list of individual ad segment objects attributed to the specified sponsor, ordered newest-episode-first. Each segment includes metadata about the episode, podcast, and ad placement. A cursor is returned for keyset pagination through additional results.","failureModes":["Invalid or unknown sponsor ID returns a 404 not found error","Malformed ISO 8601 date in `since` or `until` causes a 400 bad request","Invalid pagination cursor causes a 400 or empty result set","Unknown podcast_id causes empty results or 404","Exceeding rate limits or payment failure (x402) results in 402 Payment Required","No segments found for sponsor returns empty list with no error"],"whenToPreferThis":"Use this endpoint when you need granular, per-segment ad placement data for a specific sponsor rather than aggregate advertising intelligence. Prefer this over the company advertising profile endpoint when you need a chronological feed of individual ad segments with date-range filtering or podcast-scoped results. Best for tracking campaign recency, auditing ad frequency, or building historical timelines of a brand's podcast presence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:17.709Z","isFirstParty":false}