YouTubeYouTubeSocial

List a YouTube video's caption tracks by video id

youtube.x.youtube-captions-list

captions.list — Retrieves a list of resources, possibly filtered.

Price: freeAt provider cost
Success rate: 100%Last 30 days · 77 calls
Latency p50: 265 msp95 564 ms
Last verified: —Not verified yet

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

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description
Query parameters
`id`	string	Optional	Returns the captions with the given IDs for Stubby or Apiary.
`part`	string	Required	The part parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.
`videoId`	string	Required	Returns the captions for the specified video.
`onBehalfOf`	string	Optional	ID of the Google+ Page for the channel that the request is 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

Query parameters
idstringOptional
Returns the captions with the given IDs for Stubby or Apiary.
partstringRequired
The *part* parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.
videoIdstringRequired
Returns the captions for the specified video.
onBehalfOfstringOptional
ID of the Google+ Page for the channel that the request is 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-list' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/youtube.x.youtube-captions-list",
    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-list", {
  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.