youtube_video
Fetch YouTube video or Short details—description, owner identity, paid-promotion status, and replay heatmaps—from a URL to verify content and analyze performance.
Instructions
youtube: Video/Short Details. GET /v1/youtube/video. Get YouTube video or Short details, description cards, AI disclosures, owner/uploader identities, paid-promotion status and replay heatmaps. Age-restricted videos return 403. No hosted video downloads. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "youtube_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube video or short URL | |
| language | No | Preferred two-letter response language, such as en, es, or fr. Sets Accept-Language; YouTube may ignore it. | |
| cache_max_age | No | Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price. |