Get full video info
getVideoInfo(id, query?, options?): Video
Complete video metadata lookup. Returns everything in basic-info, plus description, view, like and comment counts, publish date, thumbnails, keywords, timestamped chapters, live and upcoming status, YouTube's AI summary and "How this was made" disclosure when YouTube shows them, the links and hashtags in the description, the songs in the video, related videos, and richer channel details. 1 credit per successful response.
Scheduled live streams and premieres return their metadata with is_upcoming: true and scheduled_start, before they begin.
Credits
Successful video-info responses deduct 1 credit. Failed lookups are not billed.
Security
API Key
All requests require a valid API key from the developer dashboard.
Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY
See Authentication for headers and rate limits.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
idpath | string | Yes | 11-character YouTube video ID or video URL. |
Response (HTTP 200)
{
"video_id": string, // Echoed YouTube video ID
"title": string, // Video title
"description": string, // Full video description
"length_seconds": number, // Duration in seconds
"view_count": number, // Current view count
"like_count": number, // Current like count
"comment_count": number, // Comment count as YouTube rounds it (e.g. 3300 for "3.3K"); omitted when comments are off
"comment_count_text": string, // The count as shown, e.g. "3.3K"
"published": number, // Unix timestamp (seconds) of publish date
"keywords": string[], // Video tags / keywords
"is_live": boolean, // Broadcasting now
"is_upcoming": boolean, // A scheduled live stream or premiere that hasn't started
"is_live_content": boolean, // A live stream, now or in the past
"scheduled_start": number, // Unix start time of an upcoming stream or premiere (upcoming only)
"channel": { // Channel metadata
"id": string, // Canonical channel ID
"title": string, // Channel display name
"url": string, // Channel URL
"subscribers": string, // Subscriber count text (e.g. "1.69M subscribers")
"subscriber_count": number, // The same, as an approximate number (1690000)
"is_verified": boolean, // YouTube's verified badge
"avatar_url": string // Channel avatar image URL
},
"thumbnails": [ // Thumbnail variants
{ "url": string, "width": number, "height": number }
],
"available_languages": [ // Available caption tracks
{
"code": string, // ISO language code (e.g. "en")
"name": string, // Display name
"kind": string // "asr" or "manual"
}
],
"chapters": [ // Timestamped chapters (omitted if none)
{
"title": string, // Chapter title
"start_time_seconds": number, // Start offset in seconds
"time_description": string // Formatted time string (e.g. "0:00")
}
],
"ai_summary": string, // YouTube's own AI summary, when it shows one
"content_disclosure": string, // YouTube's "How this was made" note, e.g. altered or synthetic content
"hashtags": string[], // Hashtags in the description and above the title
"links": [ // External links in the description (YouTube's redirect removed)
{ "text": string, "url": string }
],
"music": [ // Songs YouTube lists in the video's Music section
{ "title": string, "artist": string, "album": string }
],
"related": [ // Up to 20 videos YouTube suggests next to this one
{
"video_id": string,
"title": string,
"channel_title": string,
"channel_id": string,
"length_text": string, // e.g. "13:56", or "LIVE"
"view_count_text": string, // e.g. "9.9M", or "295 watching"
"published_text": string // e.g. "1y ago"
}
]
}Fields YouTube doesn't provide for a video are omitted. Counts that YouTube rounds (comment_count, subscriber_count) are approximate.