> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Video
> Full detail for a single YouTube video (metadata, engagement, chapters, heatmap, live details, ...).
## 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
The YouTube video id.
Video title.
Full watch URL.
Full video description (nullable).
Links extracted from the description.
Duration in seconds (nullable).
Duration as `HH:MM:SS` (nullable).
View count (nullable).
View count as displayed (nullable).
Like count (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).
Video keywords.
Video tags.
Hashtags used in the video.
Category name (nullable).
Category id (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 title.
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).
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).
`hd` or `sd` (nullable).
`2d` or `3d` (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`).
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
```json theme={null}
{
"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"
}
```
## Related Endpoints
| 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.