{"uid":"cap_K95FoG6RYws3ObPs2FhXS","slug":"particle-pro-list-speakers-in-episode-2ea801e8","name":"Particle Pro – List Speakers in Episode","description":"List speakers in an episode. Returns the identified speakers in a specific episode with their roles and speaking durations.","url":"https://api.particle.pro/v1/podcasts/episodes/:id/speakers","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":{"role":{"type":"array","items":{"type":"string"},"description":"Comma-separated speaker role filter, case-insensitive. Defaults to host,guest,panelist,correspondent — the people taking part in the conversation. Name a role to widen: 'advertiser' for sponsor reads, 'soundbite_speaker' for played clips, 'narrator'/'announcer'/'voice_actor' for scripted voices, 'audience' for callers and audience members, 'producer' for production staff, 'unknown' for speakers we could not identify, 'other' for anything else."},"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_bmgr4AZ4AhSqtZBH2mSJx","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 identified speakers in a specific podcast episode, including their roles and speaking durations.","exampleAgentPrompt":"Pull the full speaker list for the Particle Pro episode with ID 'ep_abc123' — I want to see every host, guest, and panelist along with how long each person spoke.","exampleUseCases":[{"title":"Guest lineup research for podcast pitch","prompt":"I'm pitching a sponsorship to this podcast — can you pull all the hosts and guests from episode 'hard-fork-2024-05-10' on Particle Pro so I know who the key voices are?"},{"title":"Advertiser and sponsor read detection","prompt":"For the Particle Pro episode ID 'the-daily-20240601', show me all speakers including advertisers so I can see who did the sponsor reads and for how long."},{"title":"Speaker time analytics for media monitoring","prompt":"I need to compare speaking time across participants in Particle Pro episode 'ep_xyz789' — list all the speakers with their roles and durations so I can run my own analysis."}],"resultDescription":"A list of identified speakers for the specified episode, each with their name or identifier, assigned role (e.g. host, guest, panelist, advertiser, narrator, unknown), and speaking duration. Results may be paginated with an opaque cursor for subsequent pages.","failureModes":["Episode ID not found — 404 error returned if the slug or ID does not match any episode","Invalid role filter value — unknown role strings may return empty results or a validation error","Pagination cursor expired or malformed — may return an error or restart from the beginning","No speakers detected — episode may return an empty list if diarization found no identifiable speakers","Rate limit or payment failure — x402 payment required per call; insufficient funds or expired token causes rejection"],"whenToPreferThis":"Use this endpoint when you need to know who spoke in a specific podcast episode and in what capacity (host, guest, advertiser, etc.), especially when speaking duration per person matters. Prefer this over the transcript endpoint when you only need speaker metadata without the full text. It is the right choice for audience research, sponsor analytics, guest tracking, and media monitoring workflows focused on participant identity rather than content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:46:36.472Z","isFirstParty":false}