Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube channel

GET /youtube/v1/channel
Test this endpoint

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

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

{
  "attribution": "google.com",
  "available_countries": [
    "BH",
    "GG",
    "… 247 more"
  ],
  "avatar": "https://yt3.googleusercontent.com/bAseQlKvNmjdLQrvYWm_q3QDp8C8YKyYI-nYJewgOkPi0JU1_3X9oFgjrEdzkOlXzLGFxFbnsw=s900-c-k-c0x00ffffff-no-rj",
  "avatars": [
    {
      "height": 72,
      "url": "https://yt3.googleusercontent.com/bAseQlKvNmjdLQrvYWm_q3QDp8C8YKyYI-nYJewgOkPi0JU1_3X9oFgjrEdzkOlXzLGFxFbnsw=s72-c-k-c0x00ffffff-no-rj",
      "width": 72
    },
    {
      "height": 120,
      "url": "https://yt3.googleusercontent.com/bAseQlKvNmjdLQrvYWm_q3QDp8C8YKyYI-nYJewgOkPi0JU1_3X9oFgjrEdzkOlXzLGFxFbnsw=s120-c-k-c0x00ffffff-no-rj",
      "width": 120
    },
    "… 1 more"
  ],
  "banner": "https://yt3.googleusercontent.com/H9gGqPJUwNvqOwEZBewLZiW_gV2nFdeQOugRyKv1qclCvIH4ucb6E5z5zYUOZJE4Z2E0KcS6=w2560-fcrop64=1,00005a57ffffa5a8-…",
  "banners": [
    {
      "height": 175,
      "url": "https://yt3.googleusercontent.com/H9gGqPJUwNvqOwEZBewLZiW_gV2nFdeQOugRyKv1qclCvIH4ucb6E5z5zYUOZJE4Z2E0KcS6=w1060-fcrop64=1,00005a57ffffa5a8-…",
      "width": 1060
    },
    {
      "height": 188,
      "url": "https://yt3.googleusercontent.com/H9gGqPJUwNvqOwEZBewLZiW_gV2nFdeQOugRyKv1qclCvIH4ucb6E5z5zYUOZJE4Z2E0KcS6=w1138-fcrop64=1,00005a57ffffa5a8-…",
      "width": 1138
    },
    "… 4 more"
  ],
  "cached": false,
  "canonical_url": "https://www.youtube.com/channel/UCK8sQmJBp8GCxrOtXWBpyEA",
  "credits_used": 1,
  "description": "Here to help. \n\nReimagining how AI can make your life better and help you explore your creativity, connect with the world, and discover new …",
  "featured_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 views",
        "3 days ago"
      ],
      "published": "3 days ago",
      "published_text": "3 days 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 views"
    },
    {
      "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 views",
        "7 days ago"
      ],
      "published": "7 days ago",
      "published_text": "7 days 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 views"
    },
    "… 18 more"
  ],
  "handle": "Google",
  "handle_display": "@Google",
  "header_description": "Here to help. ",
  "id": "UCK8sQmJBp8GCxrOtXWBpyEA",
  "is_family_safe": true,
  "keywords": "Google Technology Science Android \"Google app\" \"Google Doodles\" \"Google Gemini\" \"Gemini AI\" \"Google AI\" Google Android \"Google Chrome\" \"Goog…",
  "links": [
    "google.com"
  ],
  "noindex": false,
  "owner_urls": [
    "http://www.youtube.com/@Google"
  ],
  "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCK8sQmJBp8GCxrOtXWBpyEA",
  "subscriber_count": 14600000,
  "subscribers": "14.6M",
  "subscribers_text": "14.6M subscribers",
  "tabs": [
    {
      "selected": false,
      "title": "Home",
      "url": "https://www.youtube.com/@Google/featured"
    },
    {
      "selected": true,
      "title": "Videos",
      "url": "https://www.youtube.com/@Google/videos"
    },
    "… 5 more"
  ],
  "tags": [
    "Google",
    "Technology",
    "… 39 more"
  ],
  "title": "Google",
  "unlisted": false,
  "url": "http://www.youtube.com/@Google",
  "verified": true,
  "video_count": 2700,
  "video_count_text": "2.7K videos"
}
Response fields (74)

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

$object
$.attributionstring
$.available_countriesarray
$.available_countries[]string
$.avatarstring
$.avatarsarray
$.avatars[]object | string
$.avatars[].heightinteger
$.avatars[].urlstring
$.avatars[].widthinteger
$.bannerstring
$.bannersarray
$.banners[]object | string
$.banners[].heightinteger
$.banners[].urlstring
$.banners[].widthinteger
$.cachedboolean
$.canonical_urlstring
$.credits_usedinteger
$.descriptionstring
$.featured_videosarray
$.featured_videos[]object | string
$.featured_videos[].badgesarray
$.featured_videos[].badges[]string
$.featured_videos[].channel_avatarnull
$.featured_videos[].channel_idnull
$.featured_videos[].channel_namenull
$.featured_videos[].channel_urlnull
$.featured_videos[].content_typestring
$.featured_videos[].durationstring
$.featured_videos[].duration_secondsinteger
$.featured_videos[].idstring
$.featured_videos[].metadata_partsarray
$.featured_videos[].metadata_parts[]string
$.featured_videos[].publishedstring
$.featured_videos[].published_textstring
$.featured_videos[].thumbnailstring
$.featured_videos[].thumbnailsarray
$.featured_videos[].thumbnails[]object
$.featured_videos[].thumbnails[].heightinteger
$.featured_videos[].thumbnails[].urlstring
$.featured_videos[].thumbnails[].widthinteger
$.featured_videos[].titlestring
$.featured_videos[].urlstring
$.featured_videos[].view_countinteger
$.featured_videos[].viewsstring
$.handlestring
$.handle_displaystring
$.header_descriptionstring
$.idstring
$.is_family_safeboolean
$.keywordsstring
$.linksarray
$.links[]string
$.noindexboolean
$.owner_urlsarray
$.owner_urls[]string
$.rss_urlstring
$.subscriber_countinteger
$.subscribersstring
$.subscribers_textstring
$.tabsarray
$.tabs[]object | string
$.tabs[].selectedboolean
$.tabs[].titlestring
$.tabs[].urlstring
$.tagsarray
$.tags[]string
$.titlestring
$.unlistedboolean
$.urlstring
$.verifiedboolean
$.video_countinteger
$.video_count_textstring