Kanal Canlı Yayın Durumu

GET/v1/youtube/channel/live1 kredi

Bir YouTube kanalının şu anda canlı yayında olup olmadığını; yayındaysa hangi yayın olduğunu, ne zamandan beri sürdüğünü ve kaç kişinin izlediğini söyler.

01Sorgu parametreleri

Ad	Tür	Açıklama
handleisteğe bağlı	string	Kanalın kullanıcı adı, `@` ile ya da `@` olmadan (ör. `MrBeast`). `handle`, `channelId` veya `url` parametrelerinden biri zorunludur; birden fazlası verilirse önce `handle`, sonra `channelId` kullanılır.
channelIdisteğe bağlı	string	`UC` ile başlayan kanal kimliği. `handle`, `channelId` veya `url` parametrelerinden biri zorunludur.
urlisteğe bağlı	string	Kanal URL'si (ör. `https://www.youtube.com/@LofiGirl`). `handle`, `channelId` veya `url` parametrelerinden biri zorunludur.

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/channel/live?handle=LofiGirl" \
  -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/live?handle=LofiGirl

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "youtube",
  "is_live": true,
  "live_id": "0sfDth4lMLc",
  "title": "24/7 halloween ambience 🎃 spooky lofi to get chills to",
  "started_at": "2026-10-20T13:55:15Z",
  "viewer_count": 3279,
  "url": "https://www.youtube.com/watch?v=0sfDth4lMLc",
  "owner": {
    "id": "UCSJ4gkVC6NrvII8umztf0Ow",
    "username": "LofiGirl",
    "display_name": "Lofi Girl"
  }
}

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

Kendi uç noktamız (ScrapeCreators'ta YouTube için karşılığı yok); yanıt her platformda aynıdır: `platform`, `is_live`, `live_id` (video kimliği), `title`, `started_at` (ISO-8601 UTC), `viewer_count` (şu anda izleyen kişi sayısı), `url` (izleme URL'si) ve `owner` (`id` = kanal kimliği, `username` = `@` olmadan kullanıcı adı, `display_name`). Yayın, YouTube'un kanal için kendi `/live` sayfasında gösterdiği yayındır; aynı anda birden fazla yayın varsa o yayını alırsınız. Canlı olmayan bir kanal da 1 kredi tutar ve `owner` dolu, yayın alanlarının hepsi null olarak `is_live: false` döndürür. Henüz başlamamış planlanmış yayınlar ve galalar (premiere) canlı sayılmaz. Bilinmeyen bir kanal 404 döndürür ve ücretsizdir; kanal olamayacak bir değer ücretsiz 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.