{"uid":"cap_XZw7_LguRc8h8-D4tY6fW","slug":"particle-pro-list-episode-segments-0472c3cb","name":"Particle Pro – List Episode Segments","description":"List segments for an episode. Returns the AI-identified segments for a specific episode in chronological order.","url":"https://api.particle.pro/v1/podcasts/episodes/: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":"Episode slug or ID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page (default: all)"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous 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_y6OHy-iyN60kF5F61WvEf","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 the AI-identified topic segments for a specific podcast episode, listed in chronological order.","exampleAgentPrompt":"What are the AI-identified segments for the Particle Pro episode with slug 'tech-weekly-42'? Give me all of them in order.","exampleUseCases":[{"title":"Research podcast episode structure","prompt":"I'm looking into a specific episode of The Daily — can you pull up all the AI-identified topic segments for episode ID 'the-daily-20240510' from Particle Pro so I can see how it's broken down?"},{"title":"Build a podcast chapter navigator","prompt":"For my podcast app, I need the full chronological list of segments for the episode with ID 'huberman-lab-300' from Particle Pro — grab all of them so I can display chapter navigation."},{"title":"Audit advertiser placement in segments","prompt":"Can you get me all the segments for the podcast episode 'lex-fridman-400' on Particle Pro? I want to see the topic breakdown and figure out where in the episode the ads are placed."}],"resultDescription":"A chronologically ordered list of AI-identified segments for the specified episode, each containing segment metadata such as topic label, start/end timestamps, and potentially confidence scores. Includes pagination cursor if results are paginated via the limit and cursor parameters.","failureModes":["Episode ID or slug not found — 404 error","Invalid pagination cursor — 400 or empty results","No segments available for the episode (recently ingested or unprocessed)","Rate limiting or payment failure via x402 protocol — 402 error","Malformed episode ID format — 400 validation error"],"whenToPreferThis":"Use this endpoint when you need a structured, AI-generated topic breakdown of a specific podcast episode from the Particle Pro platform. It is the right choice when you already have an episode ID or slug and want to enumerate its segments in order — for building chapter navigation, auditing content structure, or analyzing topic coverage. Prefer this over podcast-level or publisher-level endpoints when you need granular, intra-episode segmentation rather than show-level metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:26.535Z","isFirstParty":false}