YTAPI.devDocs

Get full video info

getVideoInfo(id, query?, options?): Video

GET
https://api.ytapi.dev/v1/videos/{id}/video-info
1 Credit

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.

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

ParameterTypeRequiredDescription
idpath
stringYes

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.