Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube channel videos

GET /youtube/v1/channel/videos
Test this endpoint

Pass next_cursor back as cursor for the next videos. next_cursor is null on the last page.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
channelrequiredstringChannel handle (with or without `@`), channel id (UC...) or channel URL (also accepted as `channel_id` or `url`). Example: Google
sortlatest | popular | oldestlatest (default), popular or oldest: the tab's own sort chips; next_cursor keeps the order.
cursorstringCursor from `next_cursor` on the previous response; `next_cursor` is null on the last page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "channel": "Google",
  "credits_used": 1,
  "next_cursor": "4qmFsgLZCRIYVUNLOHNRbUpCcDhHQ3hyT3RYV0JweUVBGrwJOGdhRUJ4cUJCM3ItQmpyN0Jnb2tObUkyTURBellqUXRNREF3TUMweU1XTTJMV0ZoTkRZdE1UUXlNak5pWXpZNVlUbGxF…",
  "videos": [
    {
      "badges": [
        "1:13"
      ],
      "channel_avatar": null,
      "channel_id": null,
      "channel_name": null,
      "channel_url": null,
      "content_type": "video",
      "duration": "1:13",
      "duration_seconds": 73,
      "id": "WMjVP7QQyDI",
      "metadata_parts": [
        "23K",
        "3d ago"
      ],
      "published": "3d ago",
      "published_text": "3d ago",
      "thumbnail": "https://i.ytimg.com/vi/WMjVP7QQyDI/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA4wahhMZt1KqccQOigsLRguXLi1A",
      "thumbnails": [
        {
          "height": 202,
          "url": "https://i.ytimg.com/vi/WMjVP7QQyDI/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA8Hw_d2qJ8iS0UOJank1aR6SEoUQ",
          "width": 360
        },
        {
          "height": 404,
          "url": "https://i.ytimg.com/vi/WMjVP7QQyDI/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA4wahhMZt1KqccQOigsLRguXLi1A",
          "width": 720
        }
      ],
      "title": "Giannis x Google Search: Miami Pickup Hoops",
      "url": "https://youtu.be/WMjVP7QQyDI",
      "view_count": 23000,
      "views": "23K"
    },
    {
      "badges": [
        "13:54"
      ],
      "channel_avatar": null,
      "channel_id": null,
      "channel_name": null,
      "channel_url": null,
      "content_type": "video",
      "duration": "13:54",
      "duration_seconds": 834,
      "id": "eSGqW_VMMXQ",
      "metadata_parts": [
        "34K",
        "7d ago"
      ],
      "published": "7d ago",
      "published_text": "7d ago",
      "thumbnail": "https://i.ytimg.com/vi/eSGqW_VMMXQ/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB_nYBJsz7I60KyQFuxTw7ZfVxwlA",
      "thumbnails": [
        {
          "height": 202,
          "url": "https://i.ytimg.com/vi/eSGqW_VMMXQ/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDosEDDt0F4wvufAQepKAAtAIKcdw",
          "width": 360
        },
        {
          "height": 404,
          "url": "https://i.ytimg.com/vi/eSGqW_VMMXQ/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB_nYBJsz7I60KyQFuxTw7ZfVxwlA",
          "width": 720
        }
      ],
      "title": "Why the future of healthcare is prevention | Dr. Eric Topol & Josh Woodward",
      "url": "https://youtu.be/eSGqW_VMMXQ",
      "view_count": 34000,
      "views": "34K"
    },
    "… 18 more"
  ]
}
Response fields (31)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.channelstring
$.credits_usedinteger
$.next_cursorstring
$.videosarray
$.videos[]object | string
$.videos[].badgesarray
$.videos[].badges[]string
$.videos[].channel_avatarnull
$.videos[].channel_idnull
$.videos[].channel_namenull
$.videos[].channel_urlnull
$.videos[].content_typestring
$.videos[].durationstring
$.videos[].duration_secondsinteger
$.videos[].idstring
$.videos[].metadata_partsarray
$.videos[].metadata_parts[]string
$.videos[].publishedstring
$.videos[].published_textstring
$.videos[].thumbnailstring
$.videos[].thumbnailsarray
$.videos[].thumbnails[]object
$.videos[].thumbnails[].heightinteger
$.videos[].thumbnails[].urlstring
$.videos[].thumbnails[].widthinteger
$.videos[].titlestring
$.videos[].urlstring
$.videos[].view_countinteger
$.videos[].viewsstring