Scraper · YouTube
youtube.video
One YouTube video from its address or id: title, description, channel, dates, length, views, likes, tags and caption languages.
- Id
youtube.video- Version
- 1
- Billed per
- request — 1 unit for a charged run
- Runs
- within one request
Start it with POST /v1/scrapers/youtube.video/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.
Inputs
The fields of input. A field that is not listed here is refused.
| Field | Type | Description |
|---|---|---|
url | string | The video's address: a youtube.com/watch, youtu.be, /shorts/, /live/ or /embed/ link.Limit: at most 500 characters. |
video_id | string | The video's 11-character id.Limit: at most 500 characters. |
- Give exactly one of
urlandvideo_id. Both, or neither, is refused withinvalid_input.
Record fields
Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.
| Field | Type | Notes |
|---|---|---|
id | string | Always present. |
url | string | Always present. |
title | string or null | null when not known. |
description | string or null | null when not known. |
channel_name | string or null | null when not known. |
channel_id | string or null | null when not known. |
channel_url | string or null | null when not known. |
channel_handle | string or null | null when not known. |
channel_verified | boolean or null | null when not known. |
channel_subscriber_count_text | string or null | null when not known. |
published_at | string (date-time) or null | When it was made public. |
uploaded_at | string (date-time) or null | null when not known. |
published_text | string or null | The date as shown under the video ("Oct 24, 2009"). |
duration_seconds | integer or null | Null for a stream that is still live. |
view_count | integer or null | null when not known. |
like_count | integer or null | Null when the channel hides likes. |
keywords | array of string | The tags the channel gave the video. |
category | string or null | null when not known. |
is_live | boolean or null | On air now. |
is_live_content | boolean or null | A live stream, on air or ended. |
is_upcoming | boolean or null | A premiere or stream that has not started. |
live_started_at | string (date-time) or null | null when not known. |
live_ended_at | string (date-time) or null | null when not known. |
is_unlisted | boolean or null | null when not known. |
is_family_safe | boolean or null | null when not known. |
age_restricted | boolean or null | YouTube plays it only for a signed-in adult. |
playable | boolean or null | A logged-out visitor can play it here and now. |
playability_status | string or null | YouTube's own word: OK, LOGIN_REQUIRED, UNPLAYABLE, LIVE_STREAM_OFFLINE. |
playability_reason | string or null | What the player shows when it will not play. |
embeddable | boolean or null | null when not known. |
thumbnails | array of object | |
caption_tracks | array of object or null | The caption tracks offered; an empty list when the video has none; null when the page did not say (a video that does not play logged out). |
caption_languages | array of string or null | The tracks' language codes, without repeats. |
fetched_at | string (date-time) | Always present. |
Example request
curl -X POST "https://api.enrichednow.com/v1/scrapers/youtube.video/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"video_id":"dQw4w9WgXcQ"}}'The body on its own:
{
"input": {
"video_id": "dQw4w9WgXcQ"
}
}Example response
The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.
{
"id": "run_6cce2b12aaf37a10b5e1b885",
"scraper_id": "youtube.video",
"scraper_version": 1,
"status": "ok",
"reason": null,
"input": {
"video_id": "dQw4w9WgXcQ"
},
"record_count": 1,
"units": 1,
"diagnostics": {
"requests": 1,
"bytes": 232779,
"wall_ms": 565,
"facts": {}
},
"created_at": "2026-11-16T20:27:29.009834Z",
"started_at": "2026-11-16T20:27:29.013803Z",
"finished_at": "2026-11-16T20:27:29.582787Z"
}Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):
{
"records": [
{
"id": "string",
"url": "string",
"title": null,
"description": null,
"channel_name": null,
"channel_id": null,
"channel_url": null,
"channel_handle": null,
"channel_verified": null,
"channel_subscriber_count_text": null,
"published_at": null,
"uploaded_at": null,
"published_text": null,
"duration_seconds": null,
"view_count": null,
"like_count": null,
"keywords": [],
"category": null,
"is_live": null,
"is_live_content": null,
"is_upcoming": null,
"live_started_at": null,
"live_ended_at": null,
"is_unlisted": null,
"is_family_safe": null,
"age_restricted": null,
"playable": null,
"playability_status": null,
"playability_reason": null,
"embeddable": null,
"thumbnails": [],
"caption_tracks": null,
"caption_languages": null,
"fetched_at": "2026-01-01T00:00:00Z"
}
],
"next_cursor": null
}A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.