YouTube video details

Look up metadata for a public YouTube video by id or URL.

← All YouTube endpoints · Capability overview

GET/v1/youtube/video-details

https://api.vee3.io/v1/youtube/video-details

10 tokens

Look up metadata for a public YouTube video by id or URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

youtube.video_details

Parameters1 field

video_idstringRequired

YouTube video id or URL (for example PuQFESk0BrA, https://youtu.be/PuQFESk0BrA, or https://www.youtube.com/watch?v=PuQFESk0BrA).

max length 2048

Response16 fields

video_idstring

Canonical YouTube video id.

titlestring

Video title.

authorstring

Channel display name.

number_of_viewsinteger

Total view count.

video_lengthstring

Video duration in seconds as a string.

descriptionstring

Plain-text video description.

is_live_contentstring

Whether the video is live content (True or False as a string).

published_timestring

Publish date (ISO 8601).

channel_idstring

Uploader channel id.

categorystring

Primary category label.

typestring

Video type (for example NORMAL).

keywordsstring[]

Video keyword tags.

thumbnailsarrayitems

3 fields

Available thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_video_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/video-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "PuQFESk0BrA"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample video details for a YMH podcast episode.

ymh_podcast.json

{
  "video_id": "PuQFESk0BrA",
  "title": "Your Mom's House Podcast - Ep. 488 w/ Bert Kreischer",
  "author": "YMH Studios",
  "number_of_views": 1979639,
  "video_length": "7456",
  "description": "Woah Mommies, it's a very special week so pull those jeans up.",
  "is_live_content": "False",
  "published_time": "2019-02-27",
  "channel_id": "UCYIgiXwJck_Pb5Nj-wIrsqg",
  "category": "Comedy",
  "type": "NORMAL",
  "keywords": [
    "ymh",
    "your mom's house",
    "tom segura"
  ],
  "thumbnails": [
    {
      "url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg",
      "width": 168,
      "height": 94
    }
  ]
}