/video/detailsVideo Details
Video
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Access YouTube data through agntdata: Video Details. Get all publicly available details about a Youtube Video. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video metadata, channel discovery, comments, subtitles, and recommendations programmatically.
Use cases
AI agents that need YouTube data in structured form
Analytics and monitoring pipelines for YouTube content
Research and GTM workflows that combine YouTube signals with other data
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| video_id | query | string | required | —Default: PuQFESk0BrA |
Responses
Response
{
"title": "Video",
"required": [
"video_id"
],
"type": "object",
"properties": {
"video_id": {
"title": "Video Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"author": {
"title": "Author",
"type": "string"
},
"number_of_views": {
"title": "Number Of Views",
"type": "integer"
},
"video_length": {
"title": "Video Length",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"is_live_content": {
"title": "Is Live Content",
"type": "string"
},
"published_time": {
"title": "Published Time",
"type": "string"
},
"channel_id": {
"title": "Channel Id",
"type": "string"
},
"category": {
"title": "Category",
"type": "string"
},
"type": {
"title": "Type",
"type": "string",
"default": "NORMAL"
},
"keywords": {
"title": "Keywords",
"type": "array",
"items": {
"type": "string"
}
},
"thumbnails": {
"title": "Thumbnails",
"type": "array",
"items": {
"type": "object"
}
}
},
"description": "Schema Class for a Youtube video"
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Video_Details",
"method": "get",
"path": "/video/details",
"summary": "Video Details",
"description": "Get all publicly available details about a Youtube Video",
"parameters": [
{
"name": "video_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"default": "PuQFESk0BrA"
}
}
],
"responses": [
{
"statusCode": "200",
"description": "Response",
"content": {
"application/json": {
"schema": {
"title": "Video",
"required": [
"video_id"
],
"type": "object",
"properties": {
"video_id": {
"title": "Video Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"author": {
"title": "Author",
"type": "string"
},
"number_of_views": {
"title": "Number Of Views",
"type": "integer"
},
"video_length": {
"title": "Video Length",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"is_live_content": {
"title": "Is Live Content",
"type": "string"
},
"published_time": {
"title": "Published Time",
"type": "string"
},
"channel_id": {
"title": "Channel Id",
"type": "string"
},
"category": {
"title": "Category",
"type": "string"
},
"type": {
"title": "Type",
"type": "string",
"default": "NORMAL"
},
"keywords": {
"title": "Keywords",
"type": "array",
"items": {
"type": "string"
}
},
"thumbnails": {
"title": "Thumbnails",
"type": "array",
"items": {
"type": "object"
}
}
},
"description": "Schema Class for a Youtube video"
},
"example": {
"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. This week we have the fattest working comedian currently alive today. When will he die? The Mommies discuss before Bart's arrival. Plus, did you know it's SHART WEEK!?\n\nBert Kresicher arrives with all the hate in his big, over-sized heart. There is a debate about who the true Tour Bus Champ really is, plus we see never before seen clips from Brad's NETFLIX special. Do you know what a Mississippi Wet Wipe is? What's the worst smelling part of Brent's body? All these questions are answered, plus some new Sober October plans for the coming festivities. \n\nhttp://saatvamattress.com/\nhttp://yourmomshousepodcast.com/\nhttp://www.merchmethod.com/tomsegura/\nhttps://www.facebook.com/yourmomshousepodcast\nhttps://www.reddit.com/r/yourmomshousepodcast",
"is_live_content": "False",
"published_time": "2019-02-27",
"channel_id": "UCYIgiXwJck_Pb5Nj-wIrsqg",
"category": "Comedy",
"type": "NORMAL",
"keywords": [
"ymh",
"your mom's house",
"your moms house",
"tom segura",
"christina pazsitzky",
"christina p",
"mommies",
"jeans",
"up",
"high and tight",
"what's with the jeans",
"denim on denim",
"podcast"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAVzr3xrzBAumvcTN1rfWgf6k0Ffg",
"width": 168,
"height": 94
},
{
"url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLA8bb2XgAmmG0FliFnvHa88ToJbNw",
"width": 196,
"height": 110
},
{
"url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDIW7onzWaqFkntZ83G34Jy2CLcTA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDl589UI9J8P0KUvzkjIxgoGqNoww",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi_webp/PuQFESk0BrA/maxresdefault.webp",
"width": 1920,
"height": 1080
}
]
}
}
}
},
{
"statusCode": "422",
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"title": "HTTPValidationError",
"type": "object",
"properties": {
"detail": {
"title": "Detail",
"type": "array",
"items": {
"title": "ValidationError",
"required": [
"loc",
"msg",
"type"
],
"type": "object",
"properties": {
"loc": {
"title": "Location",
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
}
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
}
}
}
}
},
"example": {
"detail": [
{
"loc": [],
"msg": "",
"type": ""
}
]
}
}
}
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.
YouTube APIYouTube data APIvideo details APIAI agents data APIYouTube APIYouTube data APIYouTube for AI agents