Docs/YouTube Video Detail
Docs / API reference
POST/v1/data/youtube/video
YouTube Video Detail
Get detailed metadata for a single YouTube video including view count, likes, comment count, duration, keywords, live status, and full description.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| video_id | string | Required | YouTube video ID (e.g. 'dQw4w9WgXcQ'). 1-20 characters. |
Code example
curl -X POST "https://api.datablue.dev/v1/data/youtube/video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_id": "dQw4w9WgXcQ"
}'System responses
200 OK
Request processed successfully.
401 UNAUTHORIZED
Missing or invalid API key.
429 RATE LIMIT
System capacity exceeded.
500 SYSTEM FAILURE
Internal core exception.
Example response
{
"success": true,
"time_taken": 1.94,
"video": {
"id": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"description": "The official video for \"Never Gonna Give You Up\" by Rick Astley...",
"channel": "Rick Astley",
"channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"views": 1500000000,
"likes": 16000000,
"comment_count": 3200000,
"duration_seconds": 212,
"published": "Oct 25, 2009",
"is_live": false,
"keywords": [
"rick astley",
"never gonna give you up",
"rickroll",
"music video",
"80s",
"pop"
],
"thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
}
}