Get a transcript excerpt around a moment
Returns one segment of an episode's transcript: the latest segment starting at or before at (seconds), or the opening segment when at is omitted. A moment falling between two segments resolves to the earlier one, and a moment outside the episode clamps to the first or last segment, so the returned range does not always contain at — segment_start_seconds and segment_end_seconds report what was actually returned. Every caller gets the same excerpt for a given moment regardless of plan, so unlike the full transcript this response is cacheable and safe to render for signed-out visitors. Use this to open a deep link on a moment; use get-episode-transcript for the whole episode.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/preview
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Path parameters
Episode slug or ID
Query parameters
A moment in the episode, in seconds. Returns the latest segment starting at or before it, which is not always a segment containing it: a value falling in the gap between two segments resolves to the earlier one, and a value outside the episode clamps to the first or last segment. Read segment_start_seconds/segment_end_seconds for the range actually returned. Omit for the opening segment.
Output format: dialogue (speaker-attributed lines), text (plain text), srt (SubRip subtitles)
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.