API Reference

Universal Transcript

Extract a transcript from any supported video URL — YouTube, TikTok, Instagram, Facebook, Twitter/X, or any public video file. Automatically detects the platform and uses the optimal extraction method.

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

Parameters

Name	Type	Required	Default	Description
`url`	`string`	required	—	Full video URL from any supported platform
`lang`	`string`	optional	auto	Language code (ISO 639-1), e.g. en, es, fr
`timestamps`	`boolean`	optional	false	Include segment-level timestamps in response
`mode`	`string`	optional	auto	Extraction mode: auto, native, or generate

Code Examples

from supacrawlx import Client

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

Response

JSON

{
  "videoId": "dQw4w9WgXcQ",
  "platform": "youtube",
  "language": "en",
  "text": "We're no strangers to love...",
  "segments": [
    { "start": 0.0, "duration": 4.08, "text": "We're no strangers to love" },
    { "start": 4.08, "duration": 3.44, "text": "You know the rules and so do I" }
  ],
  "creditsUsed": 1
}

Extraction modes

auto — Uses native if available, falls back to AI generation (recommended)
native — Only uses platform-provided captions (1 credit, fails if unavailable)
generate — Always uses AI speech-to-text (2 credits/min, works on any video)