YouTube Video Detail Endpoint
Get normalized metadata for one YouTube video.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run YouTube Video Detail
Send the smallest useful request and read the structured response.
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",
"country": "us",
"language": "en"
}'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,
"views_count_status": "exact",
"likes": 16000000,
"likes_count_status": "exact",
"comment_count": 3200000,
"comment_count_status": "exact",
"duration_seconds": 212,
"duration_status": "exact",
"published": "Oct 25, 2009",
"publish_date": "2009-10-25T07:57:33-07:00",
"upload_date": "2009-10-25T07:57:33-07:00",
"owner_url": "http://www.youtube.com/@RickAstleyYT",
"category": "Music",
"is_family_safe": true,
"is_unlisted": false,
"is_short": false,
"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"
}
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
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",
"country": "us",
"language": "en"
}'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,
"views_count_status": "exact",
"likes": 16000000,
"likes_count_status": "exact"
}
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
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",
"country": "in",
"language": "en"
}'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,
"views_count_status": "exact",
"likes": 16000000,
"likes_count_status": "exact"
}
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.