# Particle Pro – List Speakers in Episode

> Particle Pro – List Speakers in Episode is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns the identified speakers in a specific podcast episode, including their roles and speaking durations.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/episodes/:id/speakers
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-list-speakers-in-episode-2ea801e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K95FoG6RYws3ObPs2FhXS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability particle-pro-list-speakers-in-episode-2ea801e8
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

List speakers in an episode. Returns the identified speakers in a specific episode with their roles and speaking durations.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-list-speakers-in-episode-2ea801e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.particle.pro](https://www.zero.xyz/host/api.particle.pro/llms.txt)
