scraper
Back to API docs

Overview

  • Overview

Discovery

  • POSTSearch
  • POSTHashtag

Content

  • POSTVideo
  • POSTChannel
  • POSTChannel Videos
  • POSTPlaylist

Details

  • POSTTranscript
  • POSTComments

YouTube Transcript

0.5 credits

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".

fieldsstring[]

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

Response Schema

dataobject

YouTube transcript result

videoIdstring

YouTube video ID

titlestring

Video title

languagestring

Language code of the returned transcript

fullTextstring

Complete transcript text without timestamps

availableLanguagesobject[]

List of available transcript languages (code, name)

segmentsobject[]

Timestamped transcript segments

countnumber

Number of transcript segments

metaobject

Request metadata

toolstring

Tool name (youtube-transcript)

creditsUsednumber

Credits consumed (1)

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.5,
    "requestId": "req_abc123"
  }
}