Channel
Subscribers, video count, description, keywords and avatar for a channel, from a handle, id or URL.
GET/v1/youtube/channel
Costs 1 credit per request. Only requests that return data are charged.
Parameters
| Name | Type | Description |
|---|---|---|
channelrequired |
string | Channel handle (@mkbhd), channel id (UC…) or any channel URL. |
Example request
curl "https://pipefetch.com/v1/youtube/channel?channel=%40mkbhd" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch('https://pipefetch.com/v1/youtube/channel?channel=%40mkbhd', {
headers: { 'x-api-key': process.env.PIPEFETCH_API_KEY },
});
const { data, credits } = await res.json();import os, requests
res = requests.get(
"https://pipefetch.com/v1/youtube/channel",
params={"channel": "@mkbhd"},
headers={"x-api-key": os.environ["PIPEFETCH_API_KEY"]},
)
data = res.json()["data"]Example response
A real answer to the request above. Long texts and lists are shortened here.
{
"data": {
"id": "UCBJycsmduvYEL83R_U4JriQ",
"handle": "@mkbhd",
"title": "Marques Brownlee",
"url": "https://www.youtube.com/@mkbhd",
"description": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC",
"keywords": [
"MKBHD",
"MarquesBrownlee"
],
"subscriberCount": 21400000,
"videoCount": 1800,
"avatarUrl": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c0x00ffffff-no-rj",
"rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCBJycsmduvYEL83R_U4JriQ",
"isFamilySafe": true
},
"credits": {
"used": 1,
"remaining": 99
}
}Good to know
- Subscriber and video counts are the rounded figures YouTube publishes (21.4M, 1.8K).
Errors
Every error has the same shape, and none of them is charged. The full list is in the error reference.
Looking for an overview and use cases? See the YouTube Channel API page.