API Reference

YouTube Batch Transcripts

Extract transcripts for up to 50 YouTube videos in a single API call. Significantly faster and more efficient than making individual requests. Requires a Pro or higher plan.

POST/v1/youtube/transcript/batch•1 credit per video

Pro+ Required

Parameters

Name	Type	Required	Default	Description
`urls`	`string[]`	required	—	Array of YouTube video URLs (max 50 per request)
`lang`	`string`	optional	en	Preferred language for all videos

Code Examples

from supacrawlx import Client

client = Client("YOUR_API_KEY")
results = client.youtube.batch_transcript([
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://www.youtube.com/watch?v=9bZkp7q19f0",
], lang="en")

for r in results:
    if r.status == "success":
        print(r.video_id, len(r.text))

Response

JSON

{
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "status": "success",
      "text": "We're no strangers to love...",
      "language": "en"
    },
    {
      "videoId": "9bZkp7q19f0",
      "status": "success",
      "text": "It's astounding...",
      "language": "en"
    }
  ],
  "successCount": 2,
  "failCount": 0,
  "creditsUsed": 2
}