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

NameTypeRequirementDescription
video_idstringRequiredYouTube 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"
  }
}