Channel search
curl --request GET \
--url https://api.scraperize.com/v1/youtube/channel/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/youtube/channel/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/youtube/channel/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/youtube/channel/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/youtube/channel/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/youtube/channel/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/youtube/channel/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"handle": "MrBeast",
"name": "MrBeast",
"url": "https://www.youtube.com/@MrBeast",
"avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"subscriberCount": 525000000
},
"query": "squid game",
"results": {
"videos": [
{
"type": "video",
"id": "0e3GPea1Tyg",
"url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
"title": "$456,000 Squid Game In Real Life!",
"descriptionSnippet": "MAKE SURE YOU WATCH UNTIL GLASS BRIDGE IT'S INSANE!\n\nWatch Beast Games now on Prime Video!!! https://www.beastgames.com\n\nThank you GoPro for supplying us with cameras to get some of these shots....",
"viewCount": 980843626,
"viewCountText": "980,843,626 views",
"concurrentViewers": null,
"publishedText": "4 years ago",
"wasLive": false,
"durationSeconds": 1542,
"durationText": "25:42",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCcnVbWoo5J0ABJHgn0oZ6gDINJPg",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLDegZWMhGR3Ca4KfKLrpWaW2Kd02g",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/0e3GPea1Tyg/mqdefault_6s.webp?du=3000&sqp=CPjCqNcG&rs=AOn4CLCdwhJcZFzmDP2amvcz6D1zSlcWgg",
"position": 1
},
{
"type": "video",
"id": "2isYuQZMbdU",
"url": "https://www.youtube.com/watch?v=2isYuQZMbdU",
"title": "100 People Fight For A Private Island",
"descriptionSnippet": "🚀Launch a store on Shopify, I’ll buy from 100 random stores that do ▸ https://shopify.com/mrbeast\n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48...",
"viewCount": 265495494,
"viewCountText": "265,495,494 views",
"concurrentViewers": null,
"publishedText": "4 years ago",
"wasLive": false,
"durationSeconds": 931,
"durationText": "15:31",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBSB5iMjDtDiWT34IZ3Bh-D__IDDg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBSB5iMjDtDiWT34IZ3Bh-D__IDDg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAW1V_jtibbtVKyrcLxXlwGN6BOnA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLAXtg_PzDthhD7dMi__QFJVnw92Yw",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/2isYuQZMbdU/mqdefault_6s.webp?du=3000&sqp=CN2oqNcG&rs=AOn4CLAnS3WfR19YItjuDiwPagc5Ir0ZgA",
"position": 3
},
{
"type": "video",
"id": "sF5LYGgKbUA",
"url": "https://www.youtube.com/watch?v=sF5LYGgKbUA",
"title": "Every Minute One Person Is Eliminated",
"descriptionSnippet": "Watch Beast Games now on Prime Video: https://linktr.ee/beastgames AmazonPrimePartner ad \n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48-QNGgCko5p2g...",
"viewCount": 186995288,
"viewCountText": "186,995,288 views",
"concurrentViewers": null,
"publishedText": "1 year ago",
"wasLive": false,
"durationSeconds": 2086,
"durationText": "34:46",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDdQ712ZMF62MMJdhnOfKSpGXiPbg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDdQ712ZMF62MMJdhnOfKSpGXiPbg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLADKj4sj0uTOESb9qtBCHXmfwSWpA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLAi-leEzBuZpLDUVtkx6BCvqf7i9Q",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/sF5LYGgKbUA/mqdefault_6s.webp?du=3000&sqp=CKCYqNcG&rs=AOn4CLBBsIPZDkJcyzKXF5xaPVDavA8EsQ",
"position": 4
}
],
"shorts": [
{
"type": "short",
"id": "DBw0oD38z0Q",
"url": "https://www.youtube.com/shorts/DBw0oD38z0Q",
"title": "This Game Is Wild",
"descriptionSnippet": null,
"viewCount": 243248747,
"viewCountText": "243,248,747 views",
"concurrentViewers": null,
"publishedText": "2 years ago",
"wasLive": false,
"durationSeconds": 21,
"durationText": "0:21",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEuLOLnsvaMUXH6xLSW1EQ",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEuLOLnsvaMUXH6xLSW1EQ",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLAYNDUkCa-lh-0ktwjyaxV3x5bK9w",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgVChPMA-4AvMY&rs=AOn4CLCSliW1MXUcj9PK7fS1kUVTSDSP5w",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/DBw0oD38z0Q/mqdefault_6s.webp?du=3000&sqp=CLSsqNcG&rs=AOn4CLBIBCQ-V-qXIIrrmIrK16qrws9P3g",
"position": 2
},
{
"type": "short",
"id": "I9mw5UlDyPI",
"url": "https://www.youtube.com/shorts/I9mw5UlDyPI",
"title": "This Game Is Wild...",
"descriptionSnippet": null,
"viewCount": 782150686,
"viewCountText": "782,150,686 views",
"concurrentViewers": null,
"publishedText": "1 year ago",
"wasLive": false,
"durationSeconds": 19,
"durationText": "0:19",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDSBA9g1v7IDR7CravjasJJoPzhcw",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDSBA9g1v7IDR7CravjasJJoPzhcw",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDQuB5YH13YoomNhSVdvb69IiAauA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgVChHMA-4AvMY&rs=AOn4CLAzLht2nDVYCFYEP3OYHMiBsjBw3g",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/I9mw5UlDyPI/mqdefault_6s.webp?du=3000&sqp=COKqqNcG&rs=AOn4CLAOKyKPvPx7aIPm_zykD7_y-MW2gQ",
"position": 5
},
{
"type": "short",
"id": "wSh8fAFWEWs",
"url": "https://www.youtube.com/shorts/wSh8fAFWEWs",
"title": "Survivor vs Beast Games",
"descriptionSnippet": null,
"viewCount": 41436103,
"viewCountText": "41,436,103 views",
"concurrentViewers": null,
"publishedText": "9 months ago",
"wasLive": false,
"durationSeconds": 28,
"durationText": "0:28",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLAtERaGNTABMqd027uzHPhwU0Yogw",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLAtERaGNTABMqd027uzHPhwU0Yogw",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLDiyzfeSfJqqBRS3gyRRTXenV5ydQ",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGFkgZShCMA-4AvMY&rs=AOn4CLA6ObFo55voYb_59NzTLi4W77s9GQ",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/wSh8fAFWEWs/mqdefault_6s.webp?du=3000&sqp=CN2oqNcG&rs=AOn4CLAZqgG2SXCU3m5EnRWICyIjyKEcdw",
"position": 6
}
],
"lives": [],
"playlists": [],
"podcasts": [],
"shows": []
},
"counts": {
"videos": 9,
"shorts": 20,
"lives": 0,
"playlists": 0,
"podcasts": 0,
"shows": 0
},
"count": 29,
"cursor": "eyJoIjoibXJiZWFzdCIsInEiOiJzcXVpZCBnYW1lIiwiYyI6IjRxbUZzZ0o2RWhoVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0VhSmtOQ01GTkNiazVzV1ZoS2FtRkVRVUpQUVVablFWZHZRV1ZuVGtoUmFsTTBRVkZCSlRORVdncHpjWFZwWkNCbllXMWxtZ0lwWW5KdmQzTmxMV1psWldSVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0Z6WldGeVkyZyUzRCIsImNoIjp7ImlkIjoiVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBIiwiaGFuZGxlIjoiTXJCZWFzdCIsIm5hbWUiOiJNckJlYXN0IiwidXJsIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vQE1yQmVhc3QiLCJhdmF0YXJVcmwiOiJodHRwczovL3l0My5nb29nbGV1c2VyY29udGVudC5jb20vbnhZcmNfMV8yZjc3RG9CYWR5eE1UbXY3WnBSWmFwSFI1amJ1WWU3UGxQZDVjSVJKeHROTkVZeU9DMFpzeGFEeUpKelhybkppdURFPXM5MDAtYy1rLWMweDAwZmZmZmZmLW5vLXJqIiwiaXNWZXJpZmllZCI6dHJ1ZSwic3Vic2NyaWJlckNvdW50Ijo1MjUwMDAwMDB9fQ",
"hasMore": true,
"fetchedAt": "2026-11-03T18:46:48.112Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}YouTube
Channel search
Searches within one YouTube channel by keyword, as the channel page’s search does, about 30 results per page grouped by type: videos (past streams included), shorts, lives (streams live now, with viewers watching), playlists, podcasts and shows, with a count per group. Every result keeps its position on the page (YouTube’s relevance order). Each video has its id, URL, title, description snippet, exact view count, when it was published, duration, badges, thumbnails and an animated preview; each playlist its id, kind, title, video count, last update and first videos. The response also carries a summary of the channel. Pass the returned cursor back (with the same handle and query) for the next page. Only publicly available data is returned.
GET
/
v1
/
youtube
/
channel
/
search
Channel search
curl --request GET \
--url https://api.scraperize.com/v1/youtube/channel/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/youtube/channel/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/youtube/channel/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/youtube/channel/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/youtube/channel/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/youtube/channel/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/youtube/channel/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"handle": "MrBeast",
"name": "MrBeast",
"url": "https://www.youtube.com/@MrBeast",
"avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"subscriberCount": 525000000
},
"query": "squid game",
"results": {
"videos": [
{
"type": "video",
"id": "0e3GPea1Tyg",
"url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
"title": "$456,000 Squid Game In Real Life!",
"descriptionSnippet": "MAKE SURE YOU WATCH UNTIL GLASS BRIDGE IT'S INSANE!\n\nWatch Beast Games now on Prime Video!!! https://www.beastgames.com\n\nThank you GoPro for supplying us with cameras to get some of these shots....",
"viewCount": 980843626,
"viewCountText": "980,843,626 views",
"concurrentViewers": null,
"publishedText": "4 years ago",
"wasLive": false,
"durationSeconds": 1542,
"durationText": "25:42",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCcnVbWoo5J0ABJHgn0oZ6gDINJPg",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLDegZWMhGR3Ca4KfKLrpWaW2Kd02g",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/0e3GPea1Tyg/mqdefault_6s.webp?du=3000&sqp=CPjCqNcG&rs=AOn4CLCdwhJcZFzmDP2amvcz6D1zSlcWgg",
"position": 1
},
{
"type": "video",
"id": "2isYuQZMbdU",
"url": "https://www.youtube.com/watch?v=2isYuQZMbdU",
"title": "100 People Fight For A Private Island",
"descriptionSnippet": "🚀Launch a store on Shopify, I’ll buy from 100 random stores that do ▸ https://shopify.com/mrbeast\n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48...",
"viewCount": 265495494,
"viewCountText": "265,495,494 views",
"concurrentViewers": null,
"publishedText": "4 years ago",
"wasLive": false,
"durationSeconds": 931,
"durationText": "15:31",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBSB5iMjDtDiWT34IZ3Bh-D__IDDg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBSB5iMjDtDiWT34IZ3Bh-D__IDDg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAW1V_jtibbtVKyrcLxXlwGN6BOnA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/2isYuQZMbdU/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLAXtg_PzDthhD7dMi__QFJVnw92Yw",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/2isYuQZMbdU/mqdefault_6s.webp?du=3000&sqp=CN2oqNcG&rs=AOn4CLAnS3WfR19YItjuDiwPagc5Ir0ZgA",
"position": 3
},
{
"type": "video",
"id": "sF5LYGgKbUA",
"url": "https://www.youtube.com/watch?v=sF5LYGgKbUA",
"title": "Every Minute One Person Is Eliminated",
"descriptionSnippet": "Watch Beast Games now on Prime Video: https://linktr.ee/beastgames AmazonPrimePartner ad \n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48-QNGgCko5p2g...",
"viewCount": 186995288,
"viewCountText": "186,995,288 views",
"concurrentViewers": null,
"publishedText": "1 year ago",
"wasLive": false,
"durationSeconds": 2086,
"durationText": "34:46",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDdQ712ZMF62MMJdhnOfKSpGXiPbg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDdQ712ZMF62MMJdhnOfKSpGXiPbg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLADKj4sj0uTOESb9qtBCHXmfwSWpA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/sF5LYGgKbUA/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLAi-leEzBuZpLDUVtkx6BCvqf7i9Q",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/sF5LYGgKbUA/mqdefault_6s.webp?du=3000&sqp=CKCYqNcG&rs=AOn4CLBBsIPZDkJcyzKXF5xaPVDavA8EsQ",
"position": 4
}
],
"shorts": [
{
"type": "short",
"id": "DBw0oD38z0Q",
"url": "https://www.youtube.com/shorts/DBw0oD38z0Q",
"title": "This Game Is Wild",
"descriptionSnippet": null,
"viewCount": 243248747,
"viewCountText": "243,248,747 views",
"concurrentViewers": null,
"publishedText": "2 years ago",
"wasLive": false,
"durationSeconds": 21,
"durationText": "0:21",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEuLOLnsvaMUXH6xLSW1EQ",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEuLOLnsvaMUXH6xLSW1EQ",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLAYNDUkCa-lh-0ktwjyaxV3x5bK9w",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgVChPMA-4AvMY&rs=AOn4CLCSliW1MXUcj9PK7fS1kUVTSDSP5w",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/DBw0oD38z0Q/mqdefault_6s.webp?du=3000&sqp=CLSsqNcG&rs=AOn4CLBIBCQ-V-qXIIrrmIrK16qrws9P3g",
"position": 2
},
{
"type": "short",
"id": "I9mw5UlDyPI",
"url": "https://www.youtube.com/shorts/I9mw5UlDyPI",
"title": "This Game Is Wild...",
"descriptionSnippet": null,
"viewCount": 782150686,
"viewCountText": "782,150,686 views",
"concurrentViewers": null,
"publishedText": "1 year ago",
"wasLive": false,
"durationSeconds": 19,
"durationText": "0:19",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDSBA9g1v7IDR7CravjasJJoPzhcw",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDSBA9g1v7IDR7CravjasJJoPzhcw",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoRzAPuALzGA==&rs=AOn4CLDQuB5YH13YoomNhSVdvb69IiAauA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/I9mw5UlDyPI/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgVChHMA-4AvMY&rs=AOn4CLAzLht2nDVYCFYEP3OYHMiBsjBw3g",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/I9mw5UlDyPI/mqdefault_6s.webp?du=3000&sqp=COKqqNcG&rs=AOn4CLAOKyKPvPx7aIPm_zykD7_y-MW2gQ",
"position": 5
},
{
"type": "short",
"id": "wSh8fAFWEWs",
"url": "https://www.youtube.com/shorts/wSh8fAFWEWs",
"title": "Survivor vs Beast Games",
"descriptionSnippet": null,
"viewCount": 41436103,
"viewCountText": "41,436,103 views",
"concurrentViewers": null,
"publishedText": "9 months ago",
"wasLive": false,
"durationSeconds": 28,
"durationText": "0:28",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLAtERaGNTABMqd027uzHPhwU0Yogw",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLAtERaGNTABMqd027uzHPhwU0Yogw",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE6CPYBEIoBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhZIGUoQjAPuALzGA==&rs=AOn4CLDiyzfeSfJqqBRS3gyRRTXenV5ydQ",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/wSh8fAFWEWs/hqdefault.jpg?sqp=-oaymwE5CMQBEG5IVfKriqkDLAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGFkgZShCMA-4AvMY&rs=AOn4CLA6ObFo55voYb_59NzTLi4W77s9GQ",
"width": 196,
"height": 110
}
],
"previewUrl": "https://i.ytimg.com/an_webp/wSh8fAFWEWs/mqdefault_6s.webp?du=3000&sqp=CN2oqNcG&rs=AOn4CLAZqgG2SXCU3m5EnRWICyIjyKEcdw",
"position": 6
}
],
"lives": [],
"playlists": [],
"podcasts": [],
"shows": []
},
"counts": {
"videos": 9,
"shorts": 20,
"lives": 0,
"playlists": 0,
"podcasts": 0,
"shows": 0
},
"count": 29,
"cursor": "eyJoIjoibXJiZWFzdCIsInEiOiJzcXVpZCBnYW1lIiwiYyI6IjRxbUZzZ0o2RWhoVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0VhSmtOQ01GTkNiazVzV1ZoS2FtRkVRVUpQUVVablFWZHZRV1ZuVGtoUmFsTTBRVkZCSlRORVdncHpjWFZwWkNCbllXMWxtZ0lwWW5KdmQzTmxMV1psWldSVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0Z6WldGeVkyZyUzRCIsImNoIjp7ImlkIjoiVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBIiwiaGFuZGxlIjoiTXJCZWFzdCIsIm5hbWUiOiJNckJlYXN0IiwidXJsIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vQE1yQmVhc3QiLCJhdmF0YXJVcmwiOiJodHRwczovL3l0My5nb29nbGV1c2VyY29udGVudC5jb20vbnhZcmNfMV8yZjc3RG9CYWR5eE1UbXY3WnBSWmFwSFI1amJ1WWU3UGxQZDVjSVJKeHROTkVZeU9DMFpzeGFEeUpKelhybkppdURFPXM5MDAtYy1rLWMweDAwZmZmZmZmLW5vLXJqIiwiaXNWZXJpZmllZCI6dHJ1ZSwic3Vic2NyaWJlckNvdW50Ijo1MjUwMDAwMDB9fQ",
"hasMore": true,
"fetchedAt": "2026-11-03T18:46:48.112Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Cost: 1 credit per successful request. Errors and cache hits (
cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt
I want to make an API call to /v1/youtube/channel/search. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/youtube/channel/search
Description: Searches within one YouTube channel by keyword, as the channel page's search does, about 30 results per page grouped by type: `videos` (past streams included), `shorts`, `lives` (streams live now, with viewers watching), `playlists`, `podcasts` and `shows`, with a count per group. Every result keeps its `position` on the page (YouTube's relevance order). Each video has its id, URL, title, description snippet, exact view count, when it was published, duration, badges, thumbnails and an animated preview; each playlist its id, kind, title, video count, last update and first videos. The response also carries a summary of the channel. Pass the returned `cursor` back (with the same handle and query) for the next page. Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- handle (string) [required]: The channel handle, with or without `@`, e.g. `MrBeast`.
- query (string) [required]: The keyword(s) to search the channel for (up to 200 characters).
- cursor (string): The `cursor` from the previous page, to get the next one. Omit for the first page.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"handle": "MrBeast",
"name": "MrBeast",
"url": "https://www.youtube.com/@MrBeast",
"avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"subscriberCount": 525000000
},
"query": "squid game",
"results": {
"videos": [
{
"type": "video",
"id": "0e3GPea1Tyg",
"url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
"title": "$456,000 Squid Game In Real Life!",
"descriptionSnippet": "MAKE SURE YOU WATCH UNTIL GLASS BRIDGE IT'S INSANE!\n\nWatch Beast Games now on Prime Video!!! https://www.beastgames.com\n\nThank you GoPro for supplying us with c…",
"viewCount": 980843626,
"viewCountText": "980,843,626 views",
"concurrentViewers": null,
"publishedText": "4 years ago",
"wasLive": false,
"durationSeconds": 1542,
"durationText": "25:42",
"badges": [
"CC"
],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB1O9sjwkfsmjOvuR2hP0qvN9ZXFg",
"width": 336,
"height": 188
}
],
"previewUrl": "https://i.ytimg.com/an_webp/0e3GPea1Tyg/mqdefault_6s.webp?du=3000&sqp=CPjCqNcG&rs=AOn4CLCdwhJcZFzmDP2amvcz6D1zSlcWgg",
"position": 1
}
],
"shorts": [
{
"type": "short",
"id": "DBw0oD38z0Q",
"url": "https://www.youtube.com/shorts/DBw0oD38z0Q",
"title": "This Game Is Wild",
"descriptionSnippet": null,
"viewCount": 243248747,
"viewCountText": "243,248,747 views",
"concurrentViewers": null,
"publishedText": "2 years ago",
"wasLive": false,
"durationSeconds": 21,
"durationText": "0:21",
"badges": [],
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelName": "MrBeast",
"channelHandle": "MrBeast",
"isChannelVerified": true,
"thumbnailUrl": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEu…",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/DBw0oD38z0Q/hqdefault.jpg?sqp=-oaymwE6CNACELwBSFXyq4qpAywIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFQoTzAPuALzGA==&rs=AOn4CLC7nAEMjEu…",
"width": 336,
"height": 188
}
],
"previewUrl": "https://i.ytimg.com/an_webp/DBw0oD38z0Q/mqdefault_6s.webp?du=3000&sqp=CLSsqNcG&rs=AOn4CLBIBCQ-V-qXIIrrmIrK16qrws9P3g",
"position": 2
}
],
"lives": [],
"playlists": [],
"podcasts": [],
"shows": []
},
"counts": {
"videos": 9,
"shorts": 20,
"lives": 0,
"playlists": 0,
"podcasts": 0,
"shows": 0
},
"count": 29,
"cursor": "eyJoIjoibXJiZWFzdCIsInEiOiJzcXVpZCBnYW1lIiwiYyI6IjRxbUZzZ0o2RWhoVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0VhSmtOQ01GTkNiazVzV1ZoS2FtRkVRVUpQUVVablFWZHZRV1ZuVGto…",
"hasMore": true,
"fetchedAt": "2026-11-03T18:46:48.112Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
The channel handle, with or without @, e.g. MrBeast.
The keyword(s) to search the channel for (up to 200 characters).
The cursor from the previous page, to get the next one. Omit for the first page.
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d