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.

Target Latency

1.2s - 4.5s

Credits

1 cr/req

Parameters

NameTypeRequirementDescription
video_idstringREQUIREDYouTube video ID (e.g. 'dQw4w9WgXcQ'). 1-20 characters.

cURL 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"
  }
}