Fetch a video
Fetch a single video's details and metrics by its id.
GET /v1/youtube/video/{video_id}
Path parameter
| Parameter | Description |
|---|---|
video_id | The 11-character video id, e.g. dQw4w9WgXcQ. See identifiers. |
Example
curl "$LISTENX_BASE/v1/youtube/video/abc123XYZ01" \
-H "X-API-Key: $LISTENX_KEY"
Response
{
"video": {
"video_id": "abc123XYZ01",
"url": "https://www.youtube.com/watch?v=abc123XYZ01",
"title": "The best electric cars of 2026",
"description": "We rank this year's top EVs on range, price and charging…",
"channel": "Auto Review",
"channel_id": "UC000000000000000000001",
"length_seconds": 872,
"views": 184203,
"like_count": 12043,
"like_count_text": "12K",
"comment_count": 1288,
"keywords": ["electric cars", "EV", "range test"],
"is_live": false,
"thumbnail": "https://i.ytimg.com/vi/abc123XYZ01/hqdefault.jpg",
"published_at": "2026-10-20T00:00:00+00:00",
"upload_date": "2026-10-20",
"category": "Autos & Vehicles",
"is_private": false,
"is_upcoming": false
},
"billing": {
"endpoint": "youtube.video",
"units": 1,
"unit_price": "0.010000",
"amount": "0.010000",
"balance_after": "19.990000",
"request_id": "…"
}
}
Fields
| Field | Description |
|---|---|
video_id | The video id. |
url | Canonical watch URL. |
title / description | Video title and description. |
channel / channel_id | Channel name and id — pass the id to the channel endpoint. |
length_seconds | Duration in seconds. |
views | View count (null if unavailable, never 0). |
like_count | Like count, when available (null if the creator hides it). |
like_count_text | Like count as shown on YouTube, e.g. 12K. |
comment_count | Total comment count, when available (null if comments are disabled). |
keywords[] | Creator-supplied tags, when available. |
is_live | true while the video is a live stream. |
thumbnail | Preview image URL. |
published_at | Publish date (ISO-8601), when available. |
upload_date | Upload date (YYYY-MM-DD), when available. |
category | YouTube's own category for the video. |
is_private / is_upcoming | Status flags. |
Billing
Billed per request — 1 unit per call. See Billing.
Errors
| HTTP | code | Meaning |
|---|---|---|
| 404 | not_found | The video is private, removed, or does not exist. |
| 429 | upstream_rate_limited | Transient upstream block — retry with backoff. |