Skip to the content
EnrichedNowDocs

    Type to search every page.

    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.

    Inputs of youtube.video
    FieldTypeDescription
    urlstringThe video's address: a youtube.com/watch, youtu.be, /shorts/, /live/ or /embed/ link.Limit: at most 500 characters.
    video_idstringThe video's 11-character id.Limit: at most 500 characters.
    • Give exactly one of url and video_id. Both, or neither, is refused with invalid_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.

    Record fields of youtube.video
    FieldTypeNotes
    idstringAlways present.
    urlstringAlways present.
    titlestring or nullnull when not known.
    descriptionstring or nullnull when not known.
    channel_namestring or nullnull when not known.
    channel_idstring or nullnull when not known.
    channel_urlstring or nullnull when not known.
    channel_handlestring or nullnull when not known.
    channel_verifiedboolean or nullnull when not known.
    channel_subscriber_count_textstring or nullnull when not known.
    published_atstring (date-time) or nullWhen it was made public.
    uploaded_atstring (date-time) or nullnull when not known.
    published_textstring or nullThe date as shown under the video ("Oct 24, 2009").
    duration_secondsinteger or nullNull for a stream that is still live.
    view_countinteger or nullnull when not known.
    like_countinteger or nullNull when the channel hides likes.
    keywordsarray of stringThe tags the channel gave the video.
    categorystring or nullnull when not known.
    is_liveboolean or nullOn air now.
    is_live_contentboolean or nullA live stream, on air or ended.
    is_upcomingboolean or nullA premiere or stream that has not started.
    live_started_atstring (date-time) or nullnull when not known.
    live_ended_atstring (date-time) or nullnull when not known.
    is_unlistedboolean or nullnull when not known.
    is_family_safeboolean or nullnull when not known.
    age_restrictedboolean or nullYouTube plays it only for a signed-in adult.
    playableboolean or nullA logged-out visitor can play it here and now.
    playability_statusstring or nullYouTube's own word: OK, LOGIN_REQUIRED, UNPLAYABLE, LIVE_STREAM_OFFLINE.
    playability_reasonstring or nullWhat the player shows when it will not play.
    embeddableboolean or nullnull when not known.
    thumbnailsarray of object
    caption_tracksarray of object or nullThe 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_languagesarray of string or nullThe tracks' language codes, without repeats.
    fetched_atstring (date-time)Always present.

    Example request

    Shell
    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:

    JSON
    {
      "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.

    JSON
    {
      "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):

    JSON
    {
      "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.