Get basic video info
getVideoBasicInfo(id, query?, options?): VideoBasicInfo
Free lookup. Returns essential video metadata: title, duration, channel attribution, and available caption languages without consuming credits or YouTube Data API quota. Use it as a quick pre-check or validation step before spending credits on transcript extraction or full metadata.
Credits
Successful basic-info responses are completely free (0 credits). 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
"length_seconds": number, // Duration in seconds
"channel": { // Channel attribution
"id": string, // Canonical channel ID
"title": string, // Channel display name
"url": string // Channel URL
},
"available_languages": [ // Caption tracks advertised for the video
{
"code": string, // ISO language code (e.g. "en")
"name": string, // Display name (e.g. "English (auto-generated)")
"kind": string // "asr" or "manual"
}
]
}Videos
Free basic video info, the complete payload (chapters, comment count, live status, links, music, related videos), most replayed moments and comments.
Complete video metadata including description, view, like and comment counts, live status, chapters, YouTube's AI summary, description links and hashtags, music, and related videos.