Skip to main content
GET
/
v1
/
podcasts
/
episodes
/
{id}
/
transcript
/
words
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/words"
{
  "episode_id": "<string>",
  "has_more": true,
  "words": [
    {
      "end_seconds": 123,
      "start_seconds": 123,
      "text": "<string>",
      "speaker": "<string>",
      "type": "<string>"
    }
  ],
  "cursor": "<string>",
  "language": "<string>"
}

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

Episode slug or ID

Query Parameters

start
number<double>

Start time in seconds

end
number<double>

End time in seconds

limit
integer<int64>

Max words per page. Omit to return all matching words.

Required range: 1 <= x <= 5000
cursor
string

Opaque pagination cursor from a previous response.

exclude_spacing
boolean

Drop type:"spacing" tokens (whitespace between words). Pass true for NLP, search, and LLM consumption — roughly halves the payload. Leave false for caption/karaoke rendering where inter-word timing matters.

Response

OK

episode_id
string
required

Parent episode ID

has_more
boolean
required

Whether more words exist beyond this page

words
object[] | null
required

Word-level timestamped transcript

cursor
string

Pass to next request for more results

language
string

Transcript language code