Channel Shorts
The Shorts of a channel, newest first, with view counts and thumbnails.
GET/v1/youtube/channel/shorts
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. |
limitoptional |
integer | How many of the latest Shorts to return. Default: 20. From 1 to 40. |
Example request
curl "https://pipefetch.com/v1/youtube/channel/shorts?channel=%40MrBeast&limit=20" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch('https://pipefetch.com/v1/youtube/channel/shorts?channel=%40MrBeast&limit=20', {
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/shorts",
params={"channel": "@MrBeast", "limit": 20},
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": {
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"name": "MrBeast",
"url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA"
},
"shorts": [
{
"videoId": "sHpEqeSByPI",
"url": "https://www.youtube.com/shorts/sHpEqeSByPI",
"title": "Unboxing The World’s Largest Toy",
"viewCount": 22000000,
"viewCountIsExact": false,
"thumbnailUrl": "https://i.ytimg.com/vi/sHpEqeSByPI/sardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLB2V7YWBrDdLVa4cnMdEBvQYu00hA"
},
{
"videoId": "kPI9Mc35mOg",
"url": "https://www.youtube.com/shorts/kPI9Mc35mOg",
"title": "Trap Door Roulette",
"viewCount": 103000000,
"viewCountIsExact": false,
"thumbnailUrl": "https://i.ytimg.com/vi/kPI9Mc35mOg/sardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCFqW_X3pokjvblVc71mCamXfPyhQ"
}
]
},
"credits": {
"used": 1,
"remaining": 99
}
}Good to know
- View counts are YouTube's rounded display values (22M). A channel without Shorts answers 404 no_shorts and costs nothing.
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 Shorts API page.