API Reference

YouTube Transcript

Extract the transcript from a YouTube video. Supports multiple languages, timestamps, and both native captions and AI-generated transcripts when captions are unavailable.

GET/v1/youtube/transcript•1 credit (native) · 2 credits/min (AI)

Parameters

Name	Type	Required	Default	Description
`url`	`string`	optional	—	Full YouTube video URL. Use either url or videoId.
`videoId`	`string`	optional	—	YouTube video ID (e.g. dQw4w9WgXcQ). Use either url or videoId.
`lang`	`string`	optional	en	Preferred language code (ISO 639-1)
`mode`	`string`	optional	auto	Extraction mode: auto, native, or generate
`timestamps`	`boolean`	optional	false	Include segment-level timestamps

Code Examples

from supacrawlx import Client

client = Client("YOUR_API_KEY")
result = client.youtube.transcript(
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    lang="en"
)
print(result.text)

Response

JSON

{
  "videoId": "dQw4w9WgXcQ",
  "language": "en",
  "text": "We're no strangers to love...",
  "segments": [
    { "start": 0.0, "duration": 4.08, "text": "We're no strangers to love" }
  ],
  "creditsUsed": 1
}