YouTubeYouTubeSocial

Batch stats for your YouTube videos by video ids

youtube.x.youtube-videos-batchgetstats

videos.batchGetStats — Retrieves a batch of VideoStat resources, possibly filtered. BatchGetStats is intentionally not atomic to provide a better user experience.

Price: freeAt provider cost
Success rate: —No success-rate data yetNo success-rate data yet
Latency p50: ——
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-videos-batchgetstatsPreview

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description
Query parameters
`id`	string	Optional	Required. Return videos with the given ids. The number of IDs specified cannot exceed 50.
`part`	string	Optional	Required. The `part` parameter specifies a comma-separated list of one or more `videoStat` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a `vide
`onBehalfOfContentOwner`	string	Optional	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 param

Query parameters
idstringOptional
Required. Return videos with the given ids. The number of IDs specified cannot exceed 50.
partstringOptional
Required. The `**part**` parameter specifies a comma-separated list of one or more `videoStat` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a `vide
onBehalfOfContentOwnerstringOptional
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 param

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-videos-batchgetstats' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

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