Get Video

Path Parameters

string

required

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

Query Parameters

string

default:"US"

Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.

string

default:"en"

UI / interface language (BCP-47). Examples: en, de, fr, ja.

Response

string

The YouTube video id.

string

Video title.

string

Full watch URL.

string

Full video description (nullable).

array

Links extracted from the description.

integer

Duration in seconds (nullable).

string

Duration as HH:MM:SS (nullable).

integer

View count (nullable).

string

View count as displayed (nullable).

integer

Like count (nullable).

string

Like count as displayed (nullable).

integer

Comment count (nullable).

integer

Dislike count — private platform-wide since 2021, always null.

string

Uploader channel id (nullable).

string

Uploader channel name (nullable).

string

Uploader @handle (nullable).

string

Uploader channel URL (nullable).

string

Uploader avatar URL (nullable).

boolean

Whether the channel is verified (nullable).

boolean

Whether the channel is an official artist channel (nullable).

integer

Channel subscriber count (nullable).

string

Subscriber count as displayed (nullable).

string

ISO 8601 publish timestamp (nullable).

number

Unix publish timestamp (nullable).

string

ISO 8601 upload timestamp (nullable).

number

Unix upload timestamp (nullable).

string

Relative publish text, e.g. 13 years ago (nullable).

array

Video keywords.

array

Video tags.

array

Hashtags used in the video.

string

Category name (nullable).

string

Category id (nullable).

array

Wikipedia topic URLs (official-API only; usually empty).

array

Thumbnail objects with url, width, height.

string

Best/primary thumbnail URL (nullable).

object

Storyboard spec, if present (nullable).

array

Video chapters.

Show Chapter object

string

Chapter title.

integer

Chapter start offset in seconds.

string

Chapter start as displayed.

string

Chapter thumbnail URL (nullable).

array

Most-replayed graph points.

Show HeatMarker object

number

Marker start offset in seconds.

number

Marker duration in seconds.

number

Normalized replay intensity (0.0-1.0).

boolean

Whether the video is/was a live broadcast (nullable).

boolean

Whether the stream is currently live (nullable).

boolean

Whether it is an upcoming premiere/stream (nullable).

object

Live/premiere timing with actual_start_at, scheduled_start_at, concurrent_viewers, active_live_chat_id (nullable).

boolean

Whether the video is family-safe (nullable).

boolean

Whether age-restricted (nullable).

boolean

Whether members-only (nullable).

boolean

Whether unlisted (nullable).

boolean

Whether private (nullable).

boolean

Whether the video is a Short (nullable).

boolean

Whether the video is monetized (nullable).

boolean

Whether comments are disabled (nullable).

boolean

Whether the video declares paid placement (nullable).

array

ISO country codes where the video is available.

object

Region restriction with allowed and blocked country lists (nullable).

string

Playability status, e.g. OK (nullable).

string

hd or sd (nullable).

string

2d or 3d (nullable).

string

rectangular or 360 (nullable).

boolean

Whether captions exist (nullable).

array

Available caption language codes.

array

Product shelf entries with title, price, vendor, thumbnail, link.

Related video objects (also available via /related).

Token to page related videos (nullable).

string

Sound id (Shorts, nullable).

string

Sound title (Shorts, nullable).

object

Streaming data — only populated when requested via /streams (nullable).

string

Embeddable player URL (nullable).

string

ISO 8601 timestamp when the video was scraped.

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"
}

Endpoint	Description
`GET /v1/youtube/videos/{video_id}/related`	Related / recommended videos (returns `results` + `continuation`).
`GET /v1/youtube/videos/{video_id}/streams`	Streaming formats (muxed + adaptive); `client` selects `ANDROID_VR`/`IOS`. 15 credits.
`GET /v1/youtube/videos/{video_id}/live_chat`	Live chat / chat replay messages (`continuation` paginated).
`POST /v1/youtube/videos/batch`	Up 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.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Path Parameters

Query Parameters

Response

Example Response

​Path Parameters

​Query Parameters

​Response

​Example Response

​Related Endpoints

Path Parameters

Query Parameters

Response

Example Response

Related Endpoints