Skip to main content

Fetch a video

Fetch a single video's details and metrics by its id.

GET /v1/youtube/video/{video_id}

Path parameter​

ParameterDescription
video_idThe 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​

FieldDescription
video_idThe video id.
urlCanonical watch URL.
title / descriptionVideo title and description.
channel / channel_idChannel name and id — pass the id to the channel endpoint.
length_secondsDuration in seconds.
viewsView count (null if unavailable, never 0).
like_countLike count, when available (null if the creator hides it).
like_count_textLike count as shown on YouTube, e.g. 12K.
comment_countTotal comment count, when available (null if comments are disabled).
keywords[]Creator-supplied tags, when available.
is_livetrue while the video is a live stream.
thumbnailPreview image URL.
published_atPublish date (ISO-8601), when available.
upload_dateUpload date (YYYY-MM-DD), when available.
categoryYouTube's own category for the video.
is_private / is_upcomingStatus flags.

Billing​

Billed per request — 1 unit per call. See Billing.

Errors​

HTTPcodeMeaning
404not_foundThe video is private, removed, or does not exist.
429upstream_rate_limitedTransient upstream block — retry with backoff.