Bulk jobs

Create an idempotent bulk transcript job of up to 500 videos

With translate=true, each video whose captions YouTube declines to translate is delivered in the job's language for 300 credits per started 10,000 characters of transcript (at most 1,500), on top of the delivery credit, labelled translation: served; nothing extra is charged when it cannot be delivered. That price is never part of the job's reservation. An Idempotency-Key replay keeps the stored choice.

post/v1/jobs

Request

  • Base URL: https://api.scripthaul.com
  • URL: https://api.scripthaul.com/v1/jobs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Request body

inputstring required

YouTube channel, playlist, video URL, or list: key

contents'all' | 'videos' | 'shorts'
offsetinteger
video_idsstring[]
format'json' | 'clean' | 'timestamped' | 'both' | 'srt' | 'vtt' | 'md'
view'clean' | 'timestamped' | 'both'
languagestring
fallbackboolean
translateboolean

When YouTube declines to translate a video's captions, deliver the requested language anyway for 300 credits per started 10,000 characters of transcript (at most 1,500), on top of the delivery credit; nothing extra is charged when it cannot be delivered.

webhook_urlstring uri

Response

Job accepted, with cold credits reserved when known

Changes

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