YouTube Channel API
Look up a channel by handle, id or URL and get its public profile as JSON: subscribers, video count, description, keywords and avatar.
- 100 free credits
- No card needed
- No Google Cloud project or OAuth
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"]What you get
- The channel id, handle, title and URL
- Subscriber count and video count
- Description and channel keywords
- Avatar and the channel's RSS feed URL
{
"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
}
}One GET request
Everything the endpoint accepts. The full reference, with the complete example response, is in the docs.
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. |
Good to know
- Subscriber and video counts are the rounded figures YouTube publishes (21.4M, 1.8K).
What people build with it
Resolve a handle to a channel id
Turn @handles and old /c/ or /user/ links into the stable UC… channel id other tools need.
Vet creators
Check audience size and what a channel says about itself before you reach out.
Monitor growth
Store the subscriber count every day and chart how a channel develops.
Buy credits once. Use them whenever.
This endpoint costs 1 credit per request, and a request that returns no data costs nothing. Move the slider to see what your volume costs.
One credit is one request that returns data. Requests that return nothing are free.
- $2.42 per 1,000 requests
- About $12.08 a month at this pace
- Lasts about 2.4 months at this pace
- Credits never expire
Questions and answers
Are subscriber counts exact?
They are the figures YouTube publishes, which are rounded for every channel (21.4M, not 21,412,907). Nobody outside the channel owner can see the exact number.
How can I identify the channel?
By handle (@mkbhd), by channel id (UC…) or by any channel URL, including the older /c/ and /user/ forms.
Can I get the channel's videos too?
Yes, with the channel videos endpoint, which returns the latest uploads together with the channel.
What does a request cost?
One request costs 1 credit. Credit packs start at $9 for 3,000 credits, never expire, and a request that returns no data is not charged. New accounts get 100 free credits without a card.
Step-by-step guides
More YouTube APIs
-
1 credit
YouTube Transcript API
The transcript of any public video with captions, as plain text, timestamped segments, SRT or WebVTT.
GET /v1/youtube/transcript -
1 credit
YouTube Video API
Exact views, likes and comment count, description, tags, chapters and channel for one video.
GET /v1/youtube/video -
1 credit
YouTube Channel Videos API
The latest uploads of a channel, newest first, with views, duration and publish time.
GET /v1/youtube/channel/videos -
1 credit
YouTube Shorts API
The Shorts of a channel, newest first, with view counts and thumbnails.
GET /v1/youtube/channel/shorts -
1 credit
YouTube Search API
YouTube search results for a query, with the same sorting and filters the site offers.
GET /v1/youtube/search -
1 credit / 20
YouTube Comments API
Top or newest comments of a video with likes, reply counts, pinned and hearted flags.
GET /v1/youtube/comments
Make your first request in a minute
Sign in, copy your key and call an endpoint. Your account starts with 100 free credits.