Start a transcription

Returns immediately with an id: it does not wait for the transcript. Accepts a direct audio URL or a YouTube, TikTok, Spotify or Apple Podcasts link, which is resolved for you; use /api/v1/podcasts/lookup first only when you need to choose an episode from a show. An accepted request returns 202, a rejected one still answers 4xx, so check status rather than the HTTP code: a YouTube video with captions comes back already "completed" and costs nothing. Everything else spends credits.

post/api/v1/transcriptions

Request

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

Request body

OR

Response

Job accepted

idstring
status'processing' | 'completed'

Already "completed" for caption-sourced videos: do not poll those

source_typestring
messagestring
next_actionsstring[]

Changes

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