Skip to main content

​
Path Parameters

​
video_id
string
required
The YouTube video id (the 11-character v= value, e.g. dQw4w9WgXcQ).

​
Query Parameters

​
gl
string
default:"US"
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
​
hl
string
default:"en"
UI / interface language (BCP-47). Examples: en, de, fr, ja.

​
Response

​
video_id
string
The YouTube video id.
​
title
string
Video title.
​
url
string
Full watch URL.
​
description
string
Full video description (nullable).
​
description_links
array
Links extracted from the description.
​
length_seconds
integer
Duration in seconds (nullable).
​
duration
string
Duration as HH:MM:SS (nullable).
​
view_count
integer
View count (nullable).
​
view_count_text
string
View count as displayed (nullable).
​
like_count
integer
Like count (nullable).
​
like_count_text
string
Like count as displayed (nullable).
​
comment_count
integer
Comment count (nullable).
​
dislike_count
integer
Dislike count — private platform-wide since 2021, always null.
​
channel_id
string
Uploader channel id (nullable).
​
channel_name
string
Uploader channel name (nullable).
​
channel_username
string
Uploader @handle (nullable).
​
channel_url
string
Uploader channel URL (nullable).
​
channel_thumbnail
string
Uploader avatar URL (nullable).
​
channel_is_verified
boolean
Whether the channel is verified (nullable).
​
is_official_artist
boolean
Whether the channel is an official artist channel (nullable).
​
number_of_subscribers
integer
Channel subscriber count (nullable).
​
subscriber_count_text
string
Subscriber count as displayed (nullable).
​
published_at
string
ISO 8601 publish timestamp (nullable).
​
published_utc
number
Unix publish timestamp (nullable).
​
upload_at
string
ISO 8601 upload timestamp (nullable).
​
upload_utc
number
Unix upload timestamp (nullable).
​
published_time_text
string
Relative publish text, e.g. 13 years ago (nullable).
​
keywords
array
Video keywords.
​
tags
array
Video tags.
​
hashtags
array
Hashtags used in the video.
​
category
string
Category name (nullable).
​
category_id
string
Category id (nullable).
​
topic_categories
array
Wikipedia topic URLs (official-API only; usually empty).
​
thumbnails
array
Thumbnail objects with url, width, height.
​
thumbnail
string
Best/primary thumbnail URL (nullable).
​
storyboards
object
Storyboard spec, if present (nullable).
​
chapters
array
Video chapters.
​
heatmap
array
Most-replayed graph points.
​
is_live_content
boolean
Whether the video is/was a live broadcast (nullable).
​
live_now
boolean
Whether the stream is currently live (nullable).
​
is_upcoming
boolean
Whether it is an upcoming premiere/stream (nullable).
​
live_streaming_details
object
Live/premiere timing with actual_start_at, scheduled_start_at, concurrent_viewers, active_live_chat_id (nullable).
​
is_family_safe
boolean
Whether the video is family-safe (nullable).
​
is_age_restricted
boolean
Whether age-restricted (nullable).
​
is_members_only
boolean
Whether members-only (nullable).
​
is_unlisted
boolean
Whether unlisted (nullable).
​
is_private
boolean
Whether private (nullable).
​
is_short
boolean
Whether the video is a Short (nullable).
​
is_monetized
boolean
Whether the video is monetized (nullable).
​
comments_turned_off
boolean
Whether comments are disabled (nullable).
​
has_paid_product_placement
boolean
Whether the video declares paid placement (nullable).
​
available_countries
array
ISO country codes where the video is available.
​
region_restriction
object
Region restriction with allowed and blocked country lists (nullable).
​
playability_status
string
Playability status, e.g. OK (nullable).
​
definition
string
hd or sd (nullable).
​
dimension
string
2d or 3d (nullable).
​
projection
string
rectangular or 360 (nullable).
​
captions_available
boolean
Whether captions exist (nullable).
​
caption_languages
array
Available caption language codes.
​
shopping_results
array
Product shelf entries with title, price, vendor, thumbnail, link.
​
related_videos
array
Related video objects (also available via /related).
​
related_videos_continuation
string
Token to page related videos (nullable).
​
sound_id
string
Sound id (Shorts, nullable).
​
sound_title
string
Sound title (Shorts, nullable).
​
streams
object
Streaming data — only populated when requested via /streams (nullable).
​
embed_url
string
Embeddable player URL (nullable).
​
scraped_at
string
ISO 8601 timestamp when the video was scraped.
​
scraped_utc
number
Unix timestamp when the video was scraped.

​
Example Response

{
  "video_id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video)",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "description": "The official video for “Never Gonna Give You Up” by Rick Astley...",
  "length_seconds": 213,
  "duration": "00:03:33",
  "view_count": 1600000000,
  "view_count_text": "1.6B views",
  "like_count": 18000000,
  "comment_count": 2400000,
  "dislike_count": null,
  "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "channel_name": "Rick Astley",
  "channel_username": "@RickAstleyYT",
  "channel_is_verified": true,
  "number_of_subscribers": 4200000,
  "published_at": "2009-10-25T00:00:00Z",
  "published_time_text": "13 years ago",
  "keywords": ["rick astley", "never gonna give you up"],
  "hashtags": ["#RickAstley"],
  "category": "Music",
  "category_id": "10",
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "chapters": [],
  "heatmap": [{ "start_seconds": 0.0, "duration_seconds": 2.13, "intensity": 1.0 }],
  "is_live_content": false,
  "is_family_safe": true,
  "captions_available": true,
  "caption_languages": ["en", "es", "fr"],
  "definition": "hd",
  "scraped_at": "2026-06-21T12:00:00Z"
}
EndpointDescription
GET /v1/youtube/videos/{video_id}/relatedRelated / recommended videos (returns results + continuation).
GET /v1/youtube/videos/{video_id}/streamsStreaming formats (muxed + adaptive); client selects ANDROID_VR/IOS. 15 credits.
GET /v1/youtube/videos/{video_id}/live_chatLive chat / chat replay messages (continuation paginated).
POST /v1/youtube/videos/batchUp to 50 video ids in one request (body { "video_ids": [...] }); billed 10 credits per video.
A video-detail request costs 10 credits. The /streams sub-endpoint costs 15 credits; /related and /live_chat cost 5 credits each. Failed requests are not charged.