Queue transcripts for up to 100 videos

Returns immediately with a batch_id; transcripts are fetched in the background. Poll GET /batch?id=... or pass webhook_url to be notified when it finishes. The call itself is free: 1 credit is charged per video that returns a transcript, and failed videos are never charged (e.g. 10 videos, 8 with captions = 8 credits; temporary failures are retried for you and never billed). Duplicate videos are fetched once. Send an Idempotency-Key header to make retries of this call safe. Webhooks POST {event, batch_id, status, total, succeeded, failed, credits_charged, results_url} with header X-GYT-Signature: t=<unix>,v1=<hex HMAC-SHA256 of '<t>.<raw body>' keyed with webhook_secret>. At most 5 unfinished batches per account; results are kept for 7 days.

post/batch

Request

  • Base URL: https://getyoutubetranscript.com/api/v1
  • URL: https://getyoutubetranscript.com/api/v1/batch
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Headers

Idempotency-Keystring

Repeat a request with the same key to get the original batch back instead of a new one.

Request body

videosstring[] required

Video URLs or 11-character IDs.

languagestring
timestampsboolean

Include per-line 'segments' in results.

webhook_urlstring uri

Public https URL (port 443) notified on completion.

Response

Idempotent replay: the batch created earlier with the same Idempotency-Key.

Changes

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