Kanal Shorts Videoları

GET/v1/youtube/channel/shorts1 kredi

Bir kanalın Shorts sekmesindeki kısa videoları döndürür; her birinde açıklama, izlenme, beğeni ve yorum sayısı, yayın tarihi 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: `newest`Kabul edilen değerler:`newestpopular`
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/shorts?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/shorts?handle=MrBeast

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [],
  "channels": [],
  "playlists": [],
  "shorts": [
    {
      "type": "short",
      "id": "mND4T0lzg_g",
      "url": "https://www.youtube.com/watch?v=mND4T0lzg_g",
      "title": "How People Treat You Based on Subscribers",
      "thumbnail": "https://img.youtube.com/vi/mND4T0lzg_g/maxresdefault.jpg",
      "viewCountText": "22,155,697",
      "viewCountInt": 22155697,
      "description": null,
      "commentCountText": "12K",
      "commentCountInt": 12000,
      "likeCountInt": 675919,
      "likeCountText": "675919",
      "publishDate": "2026-10-23T11:00:08-07:00",
      "genre": "Entertainment",
      "durationMs": 30000,
      "durationFormatted": "00:00:30"
    },
    {
      "type": "short",
      "id": "Y8IJi7iP5vk",
      "url": "https://www.youtube.com/watch?v=Y8IJi7iP5vk",
      "title": "Last To Fall Wins",
      "thumbnail": "https://img.youtube.com/vi/Y8IJi7iP5vk/maxresdefault.jpg",
      "viewCountText": "117,644,300",
      "viewCountInt": 117644300,
      "description": null,
      "commentCountText": "12K",
      "commentCountInt": 12000,
      "likeCountInt": 1054523,
      "likeCountText": "1054523",
      "publishDate": "2026-10-16T09:00:02-07:00",
      "genre": "Entertainment",
      "durationMs": 24000,
      "durationFormatted": "00:00:24"
    }
  ],
  "shelves": [],
  "lives": [],
  "continuationToken": "4qmFsgLDCxIYVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBGqYLOGdhMkNCcXpDRkt3Q0RLdENBb2tObVU1T1RRMllUZ3RNREF3TUMweVpqVmlMV0psTW1FdE5UZ3lOREk1WW1VMVpXRTBFb0lJUVdaelYydHNOekp5UlRscmVqbGtNVVUxZW5sbVVEVXdWSEV5V2pKbWN6aFdTWEYyV1RGU05tVjRYMjE0WDIxeE1XaDZWVEpyYzNkWVdIRnhYMHBUVUhGSVMxSkVObGhNTWxSUFpWYzBUMUpPUkdoMlZsTmhTVjl5VjFaWFNtaFBMV0ZKVWpjM1JGTlJhemd5YjIxYVpuSnZSakE1WmtWeWQzVjJTbGhxV0Y4eFZGTXlVMk4wUkc5eldXOUJOV1pP…"
}

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 48 Shorts, `shorts` 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. 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.