scraper
Back to API docs

Overview

  • Overview

Discovery

  • POSTSearch
  • POSTHashtag

Content

  • POSTVideo
  • POSTChannel
  • POSTChannel Videos
  • POSTPlaylist

Details

  • POSTTranscript
  • POSTComments

YouTube Transcript

Free

Get the transcript for a YouTube video.

POST/api/v1/tools/youtube/transcript

Parameters

urlstringrequired

YouTube video URL or video ID.

languagestring

Language code for the transcript (e.g. "en", "es"). Defaults to "en".

translateTostring

Language code to translate the selected transcript to. Omit it to return the selected transcript without translation.

fieldsstring[]

Fields to include in transcript result. Omit for defaults: videoId, title, language, isAutoGenerated, fullText (segments omitted by default to reduce payload). Use ["*"] for all fields including segments. Available fields: videoId, title, language, isAutoGenerated, fullText, availableLanguages, translationLanguages, segments, count.

Response Schema

dataobject

YouTube transcript result

videoIdstring

YouTube video ID

titlestring

Video title

languagestring

Language code of the returned transcript

isAutoGeneratedboolean

Whether the returned transcript is auto-generated by YouTube

fullTextstring

Complete transcript text without timestamps

availableLanguagesobject[]

Caption tracks with actual transcripts

translationLanguagesobject[]

Languages YouTube supports for auto-translation (informational only, not fetchable via this endpoint)

segmentsobject[]

Timestamped transcript segments

countnumber

Number of transcript segments

metaobject

Request metadata

toolstring

Tool name (youtube-transcript)

creditsUsednumber

Credits consumed (0)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/youtube/transcript \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"language": "en"
}'

Response Example

{
"data": {
"videoId": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up",
"language": "en",
"fullText": "We're no strangers to love. You know the rules and so do I..."
},
"meta": {
"tool": "youtube-transcript",
"creditsUsed": 0,
"requestId": "req_abc123"
}
}