YouTubeYouTubeSocial

Download a YouTube caption track by caption id

youtube.x.youtube-captions-download

captions.download — Downloads a caption track.

Price: freeAt provider cost
Success rate: 100%Last 30 days · 16 calls
Latency p50: 276 msp95 486 ms
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-captions-downloadPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description
Path parameters
`id`	string	Required	The ID of the caption track to download, required for One Platform.
Query parameters
`tfmt`	string	Optional	Convert the captions into this format. Supported options are sbv, srt, and vtt.
`tlang`	string	Optional	tlang is the language code; machine translate the captions into this language.
`onBehalfOf`	string	Optional	ID of the Google+ Page for the channel that the request is be on behalf of
`onBehalfOfContentOwner`	string	Optional	Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte

Path parameters
idstringRequired
The ID of the caption track to download, required for One Platform.
Query parameters
tfmtstringOptional
Convert the captions into this format. Supported options are sbv, srt, and vtt.
tlangstringOptional
tlang is the language code; machine translate the captions into this language.
onBehalfOfstringOptional
ID of the Google+ Page for the channel that the request is be on behalf of
onBehalfOfContentOwnerstringOptional
*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/youtube.x.youtube-captions-download' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/youtube.x.youtube-captions-download",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/youtube.x.youtube-captions-download", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.