Kanal Canlı Yayınları

GET/v1/youtube/channel/lives1 kredi

Bir kanalın Canlı sekmesindeki geçmiş, devam eden ve planlanmış canlı yayınları döndürür.

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; `continuationToken` gönderirseniz gerekmez.
channelIdisteğe bağlı	string	`UC` ile başlayan kanal kimliği (ör. `UCX6OQ3DkcsbYNE6H8uQQuVA`). `handle` veya `channelId` parametrelerinden biri zorunludur; `continuationToken` gönderirseniz gerekmez.
continuationTokenisteğe bağlı	string	Önceki sayfanın `continuationToken` değeri. Kanal bilgisi olmadan tek başına gönderilebilir.
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/lives?handle=IShowSpeed" \
  -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/lives?handle=IShowSpeed

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [],
  "channels": [],
  "playlists": [],
  "shorts": [],
  "shelves": [],
  "lives": [
    {
      "type": "live",
      "id": "uQlACpbi4WM",
      "url": "https://www.youtube.com/watch?v=uQlACpbi4WM",
      "title": "SPENDING THE NIGHT IN THE WORLD'S SCARIEST HAUNTED HOUSE! 🏚️😱",
      "thumbnail": "https://i.ytimg.com/vi/uQlACpbi4WM/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBTbOYBkR9ezM1mWwFyKKJlpIvOzw",
      "channel": {
        "id": "UCWsDFcIhY2DBi3GB5uykGXA",
        "title": "IShowSpeed",
        "handle": "IShowSpeed",
        "thumbnail": "https://yt3.googleusercontent.com/ieK0j0sDqI_AHDwYxZ2Wly07-R7PG4S3YMtxOWCEe1QH-I0FgimJ92tlydQa6M78YD0VaywCaw=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "88 waiting",
      "viewCountInt": 88,
      "publishedTimeText": "Scheduled for 10/26/26, 1:00 PM",
      "publishedTime": null,
      "lengthText": "Upcoming",
      "lengthSeconds": null,
      "badges": []
    },
    {
      "type": "live",
      "id": "KliV-V6SSF0",
      "url": "https://www.youtube.com/watch?v=KliV-V6SSF0",
      "title": "BUYING THE NEW iPHONE DUO!",
      "thumbnail": "https://i.ytimg.com/vi/KliV-V6SSF0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDv7yX3OJoHXjh28w-F4Ot3qM1hXg",
      "channel": {
        "id": "UCWsDFcIhY2DBi3GB5uykGXA",
        "title": "IShowSpeed",
        "handle": "IShowSpeed",
        "thumbnail": "https://yt3.googleusercontent.com/ieK0j0sDqI_AHDwYxZ2Wly07-R7PG4S3YMtxOWCEe1QH-I0FgimJ92tlydQa6M78YD0VaywCaw=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "2.5M",
      "viewCountInt": 2500000,
      "publishedTimeText": "Streamed 1 day ago",
      "publishedTime": "2026-10-24T17:07:00.544Z",
      "lengthText": "2:35:28",
      "lengthSeconds": 9328,
      "badges": []
    }
  ],
  "continuationToken": "4qmFsgKdCxIYVUNXc0RGY0loWTJEQmkzR0I1dXlrR1hBGoALOGdhY0NCcVpDSEtXQ0RxVENBb2tObVF4Wm1OaVpqWXRNREF3TUMweU1qQmlMVGhqWkRFdE5EUXhNRE13TkdNMlpqVTJFdWdIUVdaelYydHNOa056VEdKYWJqWkpZMGd4ZVcxNFRERjRSa0pKVUhCQlFVVjRaWGRRV0RCM01XUkdVM2swUkRGUk1tNW5aME52VkhWR1NFOVZXWEEzZEZRdGVpMTVhRmxKZUc4M1dWWTRSMFZOYlVwTU0zb3lNMjlZUzNkbVJHcGlVWGwyTFVwMGFYTTVaMlZtUWxoVFFYSXRTWHBUY2w5elpUaFVjbUZrTjFKbk5GaHpPVEZrY1dod1FsWmhlSEpU…"
}

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 yayın, `lives` içinde. Yanıt her zaman altı liste (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) ve `continuationToken` içerir; geçerli olmayan listeler boştur. Sonraki sayfa için `continuationToken` değerini geri gönderin; son sayfada null'dır. Her öğenin `channel` alanı ilk sayfada doludur; sonraki sayfalarda alanları null'dır. Yaklaşan yayınlarda izlenme sayısı ve süre yoktur. Bilinmeyen kanal 404 döner; bu sekmede hiçbir şeyi olmayan kanal 0 krediyle boş listeleri döner. YouTube'un reddettiği bir token 400 döner.

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.