Get transcript

getTranscript(query, options?): TranscriptResponse

GET/v1/transcripts1 Credit

Same extraction as POST /v1/transcripts, using query parameters. Useful for browser checks and short scripts. Prefer POST when sending languages arrays or larger option sets.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

video_id:string

Query param:

11-character YouTube video ID or a full video URL.

format?:string

Query param:

Output format. Same values as the POST endpoint. Default word_timestamps.

word_level?:boolean

Query param:

Include millisecond word offsets on ASR tracks. Default false.

languages?:string

Query param:

Comma-separated ISO language codes, for example en,es.

track_policy?:string

Query param:

manual_first, asr_first, manual_only, or asr_only. Default manual_first.

ReturnsExpand Collapse

video_id:string

Echoed YouTube video ID.

language:string

Negotiated ISO language code.

track_type:string

ASR or MANUAL.

format:string

Format actually returned.

data:object

Payload shape depends on format. See Extract transcript.

Get transcript

const params = new URLSearchParams({
  video_id: "dQw4w9WgXcQ",
  format: "markdown",
});

const response = await fetch(
  `https://api.ytapi.dev/v1/transcripts?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.YT_API_KEY}`,
    },
  },
);

const transcript = await response.json();
console.log(transcript);

import os
import requests

response = requests.get(
    "https://api.ytapi.dev/v1/transcripts",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
    params={"video_id": "dQw4w9WgXcQ", "format": "markdown"},
)

print(response.json())

curl -X GET "https://api.ytapi.dev/v1/transcripts?video_id=dQw4w9WgXcQ&format=markdown" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	url := "https://api.ytapi.dev/v1/transcripts?video_id=dQw4w9WgXcQ&format=markdown"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

200 example

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "track_type": "ASR",
  "format": "markdown",
  "data": {
    "markdown": "# Never Gonna Give You Up\n\n[00:00] We're no strangers to love...",
    "estimated_tokens": 420
  }
}