Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · YouTube

    youtube.channel_videos

    The latest videos on a YouTube channel's Videos tab (the first page, up to 30), newest first.

    Id
    youtube.channel_videos
    Version
    1
    Billed per
    record — 1 unit for each record of a charged run
    Runs
    within one request

    Start it with POST /v1/scrapers/youtube.channel_videos/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.channel_videos
    FieldTypeDescription
    channelrequiredstringThe channel: its address (youtube.com/@name, /channel/UC…, /c/name, /user/name), its handle (@name) or its id (UC…).Limit: at most 500 characters.
    max_resultsintegerThe most videos to return, newest first. Only the first page of the Videos tab is read (30 videos).Limit: 1 to 30. Default: 30.
    • Only the first page of the channel's Videos tab is read: 30 videos at most.

    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.channel_videos
    FieldTypeNotes
    positionintegerAlways present.
    idstringAlways present.
    urlstringAlways present.
    titlestring or nullnull when not known.
    channel_idstring or nullnull when not known.
    channel_namestring or nullnull when not known.
    published_textstring or nullAs shown ("4mo ago").
    duration_textstring or nullnull when not known.
    duration_secondsinteger or nullnull when not known.
    view_count_textstring or nullAs shown; the tab shows a rounded count beside a play icon ("123K").
    view_countinteger or nullnull when not known.
    view_count_exactboolean or nullnull when not known.
    badgesarray of string
    thumbnailsarray of object

    Example request

    Shell
    curl -X POST "https://api.enrichednow.com/v1/scrapers/youtube.channel_videos/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"channel":"@YouTube"}}'

    The body on its own:

    JSON
    {
      "input": {
        "channel": "@YouTube"
      }
    }

    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.channel_videos",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "channel": "@YouTube"
      },
      "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": [
        {
          "position": 0,
          "id": "string",
          "url": "string",
          "title": null,
          "channel_id": null,
          "channel_name": null,
          "published_text": null,
          "duration_text": null,
          "duration_seconds": null,
          "view_count_text": null,
          "view_count": null,
          "view_count_exact": null,
          "badges": [],
          "thumbnails": []
        }
      ],
      "next_cursor": null
    }

    A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.