Kanal Videoları
GET/v1/youtube/channel-videos1 kredi
Bir kanalın Videolar sekmesindeki videoları en yeniler ya da en popülerler önce olacak şekilde döndürür; her videoda açıklama, beğeni ve yorum sayısı, yayın tarihi, tür ve süre bulunur.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| handleisteğe bağlı | string | Kanalın kullanıcı adı, başında `@` olsun ya da olmasın (ör. `MrBeast`). `handle` veya `channelId` parametrelerinden biri zorunludur. |
| channelIdisteğe bağlı | string | `UC` ile başlayan kanal kimliği (ör. `UCX6OQ3DkcsbYNE6H8uQQuVA`). `handle` veya `channelId` parametrelerinden biri zorunludur. |
| sortisteğe bağlı | string | Sıralama.Varsayılan: latestKabul edilen değerler:latestpopular |
| continuationTokenisteğe bağlı | string | Önceki sayfanın `continuationToken` değeri. Aynı `handle` veya `channelId` ile birlikte gönderin. |
| regionisteğe bağlı | string | İsteğin YouTube bölgesini belirleyen iki harfli ülke kodu (ör. `US`, `GB`).Varsayılan: US |
02İstek
curl "https://api.scrapesocial.ai/v1/youtube/channel-videos?handle=MrBeast" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/youtube/channel-videos?handle=MrBeast
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"videos": [
{
"type": "video",
"id": "RE3_PGwDwhw",
"url": "https://www.youtube.com/watch?v=RE3_PGwDwhw",
"title": "Lose 150 Lbs Together, Win $250,000",
"thumbnail": "https://i.ytimg.com/vi/RE3_PGwDwhw/hq720_custom_1.jpg?sqp=CLzt-NYG-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLDeg1e4-2M-cVjZzuPXJSH1v_HrSQ",
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"title": "MrBeast",
"handle": "MrBeast",
"thumbnail": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj"
},
"viewCountText": "148,555,689",
"viewCountInt": 148555689,
"publishedTimeText": "8 days ago",
"publishedTime": "2026-10-17T17:06:59.478Z",
"lengthText": "43:17",
"lengthSeconds": 2597,
"badges": [],
"description": "Will this couple be able to lose 150 LBS together by the end?\n\nFunction Health. The most comprehensive health check. 160+ lab tests. Advanced imaging. 5x more labs than your annual physical. $1 a day / $365 a year. Check your health like Tre and Sara. Follow @function on Instagram for more. http://functionhealth.com/mrbeast @functionhealth FunctionPartner\n\nSign up for Step and get $5 from MrBeas…",
"commentCountText": "70K",
"commentCountInt": 70000,
"likeCountInt": 1985183,
"likeCountText": "1985183",
"publishDate": "2026-10-17T09:00:18-07:00",
"genre": "Entertainment",
"durationMs": 2596000,
"durationFormatted": "00:43:16"
},
{
"type": "video",
"id": "plN7JMbadRg",
"url": "https://www.youtube.com/watch?v=plN7JMbadRg",
"title": "Eat Everything In A Grocery Store, Win $1,000,000",
"thumbnail": "https://i.ytimg.com/vi/plN7JMbadRg/hq720_custom_1.jpg?sqp=CLzt-NYG-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLDoNepDBUvhPCicZ7D-SZu0q95tsw",
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"title": "MrBeast",
"handle": "MrBeast",
"thumbnail": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj"
},
"viewCountText": "299,049,213",
"viewCountInt": 299049213,
"publishedTimeText": "3 weeks ago",
"publishedTime": "2026-10-04T17:06:59.478Z",
"lengthText": "57:59",
"lengthSeconds": 3479,
"badges": [],
"description": "I trapped 4 strangers in an entire supermarket and the only way out is eating everything inside\n\nThe guys wore Fitbit Air to track their health and fitness throughout their entire time in the store. See what they achieved during the Google Health Awards. GooglePartner\nGoogle Store: https://www.jdoqocy.com/click-1009880...\nAmazon: https://www.amazon.com/Fitbit-Google-...\nAmazon CA: https://www.amaz…",
"commentCountText": "159K",
"commentCountInt": 159000,
"likeCountInt": 4353721,
"likeCountText": "4353721",
"publishDate": "2026-10-03T09:00:01-07:00",
"genre": "Entertainment",
"durationMs": 3479000,
"durationFormatted": "00:57:59"
}
],
"channels": [],
"playlists": [],
"shorts": [],
"shelves": [],
"lives": [],
"continuationToken": "4qmFsgLdCBIYVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBGsAIOGdhbkJocWtCbnFoQmpxZUJnb2tObUZtTmpjeU9UY3RNREF3TUMweU5UVmlMV0UxWXprdE5UZ3lOREk1WTJJeE9EZ3dFdk1GUVdaelYydHNORkUzV1c5Sk9GRkhiVUpxY0ZOV1NsOWxTV0U1V0RReU0wdFBTVFZHU2sxTGRqSktaRUpWWTJ0c09VdGZlVlZrY0c5dWEyOVpSVnBYVm1OaFJGb3hNbUZvYVdOV1MxbGtYMUJRYW5KYVQzSmlSMDVFU1hkTFlXVkJTamxSTXpKdlRURk5PR295VTJOU1lWaHJjSFZLZFhwM1NHNUJWbUpSTUVoR2IxOXVhVjlpV2tSMlJIb3pWV3RE…"
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
Sayfa başına 30 video, `videos` listesinde. Yanıtta her zaman altı liste (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) ve `continuationToken` bulunur; ilgisiz listeler boş gelir. Sonraki sayfa için `continuationToken` değerini aynı `handle` veya `channelId` ile geri gönderin (tek başına token 400 döner); son sayfada null olur. Öğelerdeki `channel` nesnesi yalnızca `latest` sıralamasının ilk sayfasında doldurulur. Bilinmeyen bir kanal 404 döndürür; bu sekmede hiçbir şey olmayan bir kanal boş listeleri 0 krediyle döndürür. YouTube'un kabul etmediği bir token 400 hatası verir.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.