Path Parameters
The YouTube video id (the 11-character v= value, e.g. dQw4w9WgXcQ).
Query Parameters
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
UI / interface language (BCP-47). Examples: en, de, fr, ja.
Response
Full video description (nullable).
Links extracted from the description.
Duration in seconds (nullable).
Duration as HH:MM:SS (nullable).
View count as displayed (nullable).
Like count as displayed (nullable).
Comment count (nullable).
Dislike count — private platform-wide since 2021, always null.
Uploader channel id (nullable).
Uploader channel name (nullable).
Uploader @handle (nullable).
Uploader channel URL (nullable).
Uploader avatar URL (nullable).
Whether the channel is verified (nullable).
Whether the channel is an official artist channel (nullable).
Channel subscriber count (nullable).
Subscriber count as displayed (nullable).
ISO 8601 publish timestamp (nullable).
Unix publish timestamp (nullable).
ISO 8601 upload timestamp (nullable).
Unix upload timestamp (nullable).
Relative publish text, e.g. 13 years ago (nullable).
Hashtags used in the video.
Category name (nullable).
Wikipedia topic URLs (official-API only; usually empty).
Thumbnail objects with url, width, height.
Best/primary thumbnail URL (nullable).
Storyboard spec, if present (nullable).
Video chapters. Chapter start offset in seconds.
Chapter start as displayed.
Chapter thumbnail URL (nullable).
Most-replayed graph points. Marker start offset in seconds.
Marker duration in seconds.
Normalized replay intensity (0.0-1.0).
Whether the video is/was a live broadcast (nullable).
Whether the stream is currently live (nullable).
Whether it is an upcoming premiere/stream (nullable).
Live/premiere timing with actual_start_at, scheduled_start_at, concurrent_viewers, active_live_chat_id (nullable).
Whether the video is family-safe (nullable).
Whether age-restricted (nullable).
Whether members-only (nullable).
Whether unlisted (nullable).
Whether private (nullable).
Whether the video is a Short (nullable).
Whether the video is monetized (nullable).
Whether comments are disabled (nullable).
has_paid_product_placement Whether the video declares paid placement (nullable).
ISO country codes where the video is available.
Region restriction with allowed and blocked country lists (nullable).
Playability status, e.g. OK (nullable).
rectangular or 360 (nullable).
Whether captions exist (nullable).
Available caption language codes.
Product shelf entries with title, price, vendor, thumbnail, link.
Related video objects (also available via /related).
related_videos_continuation Token to page related videos (nullable).
Sound id (Shorts, nullable).
Sound title (Shorts, nullable).
Streaming data — only populated when requested via /streams (nullable).
Embeddable player URL (nullable).
ISO 8601 timestamp when the video was scraped.
Unix timestamp when the video was scraped.
Example Response
A video-detail request costs 15 credits . The /streams sub-endpoint costs 23 credits ; /related and /live_chat cost 8 credits each. Failed requests are not charged.
Stream URLs are best-effort and exit-bound. YouTube signs each media URL with the IP that fetched it (ip= in the query string) and enforces that binding on some CDN nodes, so a URL that plays from one host may return 403 from another. Fetch promptly — they carry a short expires_in_seconds — and treat a 403 as “re-request the streams”, not as an outage. Videos YouTube serves no playable formats for (unavailable, private, or app-gated) return 404, and are not charged.