← API Store
Social
YouTube
YouTube
YouTube channel
GET /youtube/v1/channelEvery 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
| Name | Type | Description |
|---|---|---|
channelrequired | string | Channel 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 |
$.attribution | string |
$.available_countries | array |
$.available_countries[] | string |
$.avatar | string |
$.avatars | array |
$.avatars[] | object | string |
$.avatars[].height | integer |
$.avatars[].url | string |
$.avatars[].width | integer |
$.banner | string |
$.banners | array |
$.banners[] | object | string |
$.banners[].height | integer |
$.banners[].url | string |
$.banners[].width | integer |
$.cached | boolean |
$.canonical_url | string |
$.credits_used | integer |
$.description | string |
$.featured_videos | array |
$.featured_videos[] | object | string |
$.featured_videos[].badges | array |
$.featured_videos[].badges[] | string |
$.featured_videos[].channel_avatar | null |
$.featured_videos[].channel_id | null |
$.featured_videos[].channel_name | null |
$.featured_videos[].channel_url | null |
$.featured_videos[].content_type | string |
$.featured_videos[].duration | string |
$.featured_videos[].duration_seconds | integer |
$.featured_videos[].id | string |
$.featured_videos[].metadata_parts | array |
$.featured_videos[].metadata_parts[] | string |
$.featured_videos[].published | string |
$.featured_videos[].published_text | string |
$.featured_videos[].thumbnail | string |
$.featured_videos[].thumbnails | array |
$.featured_videos[].thumbnails[] | object |
$.featured_videos[].thumbnails[].height | integer |
$.featured_videos[].thumbnails[].url | string |
$.featured_videos[].thumbnails[].width | integer |
$.featured_videos[].title | string |
$.featured_videos[].url | string |
$.featured_videos[].view_count | integer |
$.featured_videos[].views | string |
$.handle | string |
$.handle_display | string |
$.header_description | string |
$.id | string |
$.is_family_safe | boolean |
$.keywords | string |
$.links | array |
$.links[] | string |
$.noindex | boolean |
$.owner_urls | array |
$.owner_urls[] | string |
$.rss_url | string |
$.subscriber_count | integer |
$.subscribers | string |
$.subscribers_text | string |
$.tabs | array |
$.tabs[] | object | string |
$.tabs[].selected | boolean |
$.tabs[].title | string |
$.tabs[].url | string |
$.tags | array |
$.tags[] | string |
$.title | string |
$.unlisted | boolean |
$.url | string |
$.verified | boolean |
$.video_count | integer |
$.video_count_text | string |