Social

YouTube video transcript

Full transcript of a video as clean prose paragraphs and timestamped blocks (markdown), with timed snippets and the joined text in data, plus the video metadata (title, channel, views, likes, publish date). Works for manual and auto-generated captions; falls back to English, then the first available track, and machine-translates into lang when no native track exists.

Provide exactly one of: video_id, url.

Credits: 1 (refunded on failure).

get/api/v1/social/youtube/transcript

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/social/youtube/transcript
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

video_idstring

11-character YouTube video id. Provide this or url.

urlstring uri

A youtube.com/watch?v=…, youtu.be/…, or youtube.com/shorts/… URL.

langstring

Preferred caption language code (en, ja, pt-BR, …). Default: English, then the first available track.

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

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