Get Video Details
youtube_get_videoRead-onlyIdempotent
Fetch complete metadata for a YouTube video using its ID, including statistics, content details, and status.
Instructions
Fetch full metadata for a single video by ID.
Calls videos.list with parts: snippet, statistics, status, contentDetails, topicDetails, player, and liveStreamingDetails.
Args
videoId (string, required): the YouTube video ID (e.g. "dQw4w9WgXcQ")
response_format: "markdown" (default) or "json"
Returns JSON shape:
{
"id": "dQw4w9WgXcQ",
"title": "Never Gonna Give You Up",
"description": "...",
"publishedAt": "2009-10-25T06:57:33Z",
"channelTitle": "Rick Astley",
"categoryId": "10",
"tags": ["rick astley", "pop"],
"duration": "PT3M32S",
"viewCount": "1400000000",
"likeCount": "15000000",
"commentCount": "2000000",
"privacyStatus": "public",
"embeddable": true,
"madeForKids": false,
"thumbnails": { ... },
"statistics": { ... },
"contentDetails": { ... }
}Examples
Get video:
{ "videoId": "dQw4w9WgXcQ" }JSON output:
{ "videoId": "dQw4w9WgXcQ", "response_format": "json" }
Errors
404: video does not exist or is private/deleted
403: insufficient permissions to view this video
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| videoId | Yes | YouTube video ID (e.g. dQw4w9WgXcQ). | |
| response_format | No | Output format: "markdown" (default) or "json". | markdown |