Skip to content

Docs

GET /v1/videos/{videoId}

GET/v1/videos/{videoId}

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

Parameters

ParameterInTypeDescription
videoIdpathstring (11 chars)YouTube video ID.
glquerystringRegion code (default US). Affects region-dependent fields.
hlquerystringResponse language hint (default en).

Response fields

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

GET/v1/videos/dQw4w9WgXcQ
1curl "https://api.ytapi.dev/v1/videos/dQw4w9WgXcQ" \
2  -H "Authorization: Bearer yta_YOUR_KEY"
200 OK
1{
2  "video_id": "dQw4w9WgXcQ",
3  "title": "Building on Cloudflare Workers",
4  "description": "Learn how to build global web applications with Cloudflare Workers...",
5  "channel_id": "UCxxxx",
6  "author": "Example Channel",
7  "length_seconds": 754,
8  "view_count": 1284503,
9  "like_count": 24188,
10  "published_at": "2026-03-14T09:00:00Z",
11  "keywords": ["cloudflare", "workers", "serverless"],
12  "category": "Science & Technology",
13  "is_live": false,
14  "is_family_safe": true,
15  "thumbnails": [{ "url": "https://i.ytimg.com/vi/.../maxres.jpg", "width": 1280, "height": 720 }]
16}