Get one transcription

Poll this after creating a job. Returns a preview by default; ?include=text for the whole body, ?format= for a subtitle or text file.

get/api/v1/transcriptions/{id}

Request

  • Base URL: https://podcaststotext.com
  • URL: https://podcaststotext.com/api/v1/transcriptions/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Query parameters

include'text'

Set to "text" for the full transcript

format'srt' | 'vtt' | 'txt' | 'md' | 'json' | 'docx' | 'pdf'

Return the transcript as a file instead of JSON. srt/vtt/json need a paid-plan transcript with timings; txt/md/docx/pdf work for any transcript.

speakersboolean

Label each cue with its speaker in srt/vtt/txt, and head each paragraph with the name in md/docx/pdf. json always includes a speaker field when the transcript has diarization.

timestampsboolean

md, docx and pdf only: head each paragraph with its start time. srt and vtt are timings already, and json carries start and end on every cue.

Response

The transcription

idstring uuid
titlestring
status'processing' | 'completed' | 'failed'
duration_secondsinteger nullable
formatstring
source_typestring nullable
source_urlstring nullable
image_urlstring nullable
show_idstring nullable
created_atstring date-time
transcript_urlstring nullable

Where the stored transcript lives

errorstring

Why the job failed. Only present when status is "failed".

previewstring

First ~500 characters. Present when the transcript is readable.

textstring

Full body. Only present with ?include=text.

Changes

No recorded changes to this operation across all 1 revision of this API.