Transcripts

Fetch up to 500 transcripts in one call (plan-dependent)

Fetch a batch of transcripts concurrently. Batch size follows your plan: up to 50 entries on the free tier, Basic and Pro, and up to 500 on Mega and Scale (a request over your plan's cap fails whole with a clear error before anything is fetched or charged). Accepts the same inputs as /transcripts/video - YouTube, TikTok and Instagram URLs as well as bare YouTube IDs. Charges 1 credit per successfully fetched transcript; failed videos are free. Entries with no caption track are transcribed from audio by default: those come back with outcome "processing" and a job_id, cost nothing on this call, and are charged on delivery at the audio rate. Re-send the same batch once they have finished and the text is returned normally - polling is optional. Send mode: "captions" to keep the old behaviour and have captionless entries fail as no_transcript instead.

post/api/v1/transcripts/batch

Request

  • Base URL: https://transcriptfetch.com
  • URL: https://transcriptfetch.com/api/v1/transcripts/batch
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Unique key (≤255 chars) to safely retry a request without being charged twice. Replays return the original response with Idempotent-Replayed: true. Reusing a key with a different body is a 409 conflict.

Request body

video_idsstring[] required

Video URLs or bare YouTube IDs, from any supported platform. Up to your plan's batch cap: 50 on free/Basic/Pro, 500 on Mega/Scale. Also accepted as the legacy key videoIds (send one or the other, not both).

mode'auto' | 'captions'

Where each entry's text may come from. "auto" (the default) reads captions and transcribes the audio when there are none. "captions" reads an existing caption track only, so a captionless video fails as no_transcript - the behaviour batch had before audio fallback existed. Note "audio" is not accepted here: skipping captions for 50 videos at once is a job queue, not a batch fetch.

Response

Success

oktrue required
request_idstring required

Changes

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