> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # List speakers in an episode > Returns the identified speakers in a specific episode with their roles and speaking durations. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/episodes/{id}/speakers openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/podcasts/episodes/{id}/speakers: get: tags: - Podcast Episodes - tier:standard summary: List speakers in an episode description: >- Returns the identified speakers in a specific episode with their roles and speaking durations. operationId: list-episode-speakers parameters: - description: 'Results per page (default: all)' explode: false in: query name: limit schema: description: 'Results per page (default: all)' format: int64 maximum: 100 minimum: 1 type: integer - description: Opaque pagination cursor from previous response explode: false in: query name: cursor schema: description: Opaque pagination cursor from previous response type: string - description: Episode slug or ID in: path name: id required: true schema: description: Episode slug or ID type: string - description: >- Comma-separated speaker role filter. Defaults to host,co_host,guest,panelist,correspondent (advertisers and unknown soundbite speakers excluded). Pass 'unknown' to include unidentified speakers, 'advertiser' to include ad reads. New writes fold co_host into host; pass co_host to query legacy rows. explode: false in: query name: role schema: description: >- Comma-separated speaker role filter. Defaults to host,co_host,guest,panelist,correspondent (advertisers and unknown soundbite speakers excluded). Pass 'unknown' to include unidentified speakers, 'advertiser' to include ad reads. New writes fold co_host into host; pass co_host to query legacy rows. examples: - - host - guest items: enum: - host - co_host - guest - panelist - correspondent - advertiser - unknown type: string maxItems: 10 type: - array - 'null' responses: '200': content: application/json: schema: $ref: '#/components/schemas/PageEpisodeSpeaker' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/episodes/{id}/speakers" components: schemas: PageEpisodeSpeaker: additionalProperties: false properties: cursor: description: Pass to next request for more results type: string data: description: List of results items: $ref: '#/components/schemas/EpisodeSpeaker' type: - array - 'null' has_more: description: Whether more results exist type: boolean required: - data - has_more type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object EpisodeSpeaker: additionalProperties: false properties: description: description: Brief description of the speaker type: string descriptor: description: >- Movie-credits-style role-in-context label for speakers we can describe but not identify by name ("Taylor's Lawyer", "Court Officer"). Co-exists with name carrying the raw STT label when no identity could be established. Rendered by clients when descriptor is non-empty and the speaker is otherwise unresolved. type: string entity: $ref: '#/components/schemas/EntityCompact' description: Linked knowledge graph entity, when this speaker is identified name: description: Speaker name type: string person: $ref: '#/components/schemas/PersonCompact' description: >- Linked first-class Person, when the speaker has been resolved to a row in /v1/people role: description: >- Speaker role. Common values: HOST, CO_HOST, GUEST, PANELIST, CORRESPONDENT, ADVERTISER. Advertisers and unidentified soundbite speakers are excluded by default; opt in via the role query param. Unidentified soundbite speakers have no role, so this field is absent on those entries (use role=unknown to include them). type: string speaking_duration_seconds: description: Total speaking time in seconds format: double type: number required: - name type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object EntityCompact: additionalProperties: false properties: company: $ref: '#/components/schemas/EntityCompany' description: Linked company record, if this entity is a known company description: description: Short description type: string id: description: Entity ID type: string image_url: description: Entity image URL type: string name: description: Entity name type: string person: $ref: '#/components/schemas/EntityPerson' description: Linked person record, if this entity is a known person slug: description: Human-readable slug identifier type: string type: $ref: '#/components/schemas/EntityType' description: Category. Omitted when the entity falls outside the supported set. wikipedia_url: description: Wikipedia URL type: string required: - id - slug - name type: object PersonCompact: additionalProperties: false properties: description: description: Short description (e.g. current role), when known. type: string id: description: Encoded Person identifier type: string image_url: description: Canonical headshot URL when one is known for the Person type: string name: description: Display name type: string slug: description: >- Stable human-readable handle (e.g. 'satya-nadella'). Recommended canonical identifier on every Particle Pro person surface. type: string required: - id - name type: object EntityCompany: additionalProperties: false properties: domain: description: Company website domain type: string id: description: Company identifier type: string ticker: description: Primary stock ticker symbol type: string required: - id type: object EntityPerson: additionalProperties: false properties: company: description: Current company name type: string id: description: Person identifier type: string image_url: description: Person headshot URL type: string title: description: Current role title type: string required: - id type: object EntityType: additionalProperties: false properties: name: description: Human-friendly display label (e.g. 'Company'). type: string slug: description: >- Stable identifier, safe to pass to the type query parameter (e.g. 'company'). type: string required: - slug - name type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````