GET /v1/videos/{videoId}

Video metadata: title, channel, duration, views, likes, publish date, keywords, thumbnails. Cost: 1 credit per successful call.

Parameters

Parameter	In	Type	Description
videoId	path	string (11 chars)	YouTube video ID.
gl	query	string	Region code (default US). Affects region-dependent fields.
hl	query	string	Response language hint (default en).

Request examples

curl "https://api.ytapi.dev/v1/videos/dQw4w9WgXcQ" \
  -H "Authorization: Bearer yta_YOUR_KEY"

Response

200 OK

{
  "video_id": "dQw4w9WgXcQ",
  "title": "Building on Cloudflare Workers",
  "description": "Learn how to build global web applications with Cloudflare Workers...",
  "channel_id": "UCxxxx",
  "author": "Example Channel",
  "length_seconds": 754,
  "view_count": 1284503,
  "like_count": 24188,
  "published_at": "2026-03-14T09:00:00Z",
  "keywords": ["cloudflare", "workers", "serverless"],
  "category": "Science & Technology",
  "is_live": false,
  "is_family_safe": true,
  "thumbnails": [{ "url": "https://i.ytimg.com/vi/.../maxres.jpg", "width": 1280, "height": 720 }]
}

like_count can be null when YouTube hides the count for a video.