Start a background job that fetches every transcript of a channel, playlist or video URL

Returns 202 with a run_id immediately. Listing is free; each transcript newly added to the caller's library costs 1 credit, cache hits and repeats are free, failures are never charged. Up to 1,000 videos per job and 2 jobs per account at a time.

post/api/v1/bulk

Request

  • Base URL: https://bulktranscripts.co
  • URL: https://bulktranscripts.co/api/v1/bulk
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

urlstring required

Channel (@handle or URL), playlist URL or id, or a single video URL.

max_videosinteger
start_atinteger

1-based position to start from, newest first.

content'videos' | 'shorts' | 'live'

Channels only: which tab to read.

languagestring

Response

Job accepted

run_idstring
status'running' | 'completed' | 'stopped' | 'failed'
phase'discovering' | 'extracting' | 'finished'
videos_foundinteger nullable

null until the listing has finished.

totalinteger
completedinteger
cachedinteger
failedinteger
skippedinteger

Videos without captions.

quotainteger

Not attempted for lack of credits.

interruptedinteger
remaininginteger
check_again_in_secondsinteger

Minimum wait before the next poll; 0 when finished.

Changes

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