Canlı yayın durumu

GET/v1/twitter/user/live1 kredi

Bir X hesabının şu anda canlı yayında olup olmadığını ya da tek bir yayının veya X Space'in durumunu söyler: yayın sürerken başlık, başlangıç zamanı, anlık izleyici ya da katılımcı sayısı ve bağlantı. Kendi uç noktamızdır: ScrapeCreators'ta X için canlı yayın uç noktası yoktur.

01Sorgu parametreleri

Ad	Tür	Açıklama
handleisteğe bağlı	string	Hesabın kullanıcı adı, örneğin `GBNEWS`. Başındaki `@` yok sayılır. `url` verilmediğinde zorunludur.
urlisteğe bağlı	string	Bir yayın bağlantısı, `https://x.com/i/broadcasts/<id>` (twitter.com ve periscope.tv bağlantıları da çalışır) ya da bir X Space bağlantısı, `https://x.com/i/spaces/<id>` (`/peek` ile veya onsuz). `handle` ile birlikte verilirse bu kullanılır.

02İstek

curl "https://api.scrapesocial.ai/v1/twitter/user/live?handle=GBNEWS" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/twitter/user/live?handle=GBNEWS

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "twitter",
  "is_live": true,
  "live_id": "1yoKMPeeqAdxQ",
  "title": "GB News",
  "started_at": "2026-10-25T12:59:57Z",
  "viewer_count": 2275,
  "url": "https://x.com/i/broadcasts/1yoKMPeeqAdxQ",
  "owner": {
    "id": "1339166129110065152",
    "username": "GBNEWS",
    "display_name": "GB News"
  }
}

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

Yanıt `platform, is_live, live_id, title, started_at, viewer_count, url, owner{id, username, display_name}` alanlarından oluşur. Canlı olsun olmasın yanıt 1 kredidir; canlı değilse yayın alanları null gelir (`url` ile sorulduğunda `live_id` sorulan yayındır). Kullanıcı adıyla sorulduğunda durum, hesabın her canlı yayın için kart taşıyan en yeni gönderilerinden okunur: gönderisiz duyurulan ya da gönderisi en yeniler arasında olmayan (yaklaşık 20; en büyük hesaplarda öne çıkan gönderiler) bir yayın görülmez. `viewer_count`, X'in kendi "izliyor" sayısıdır; bir Space için o anda içinde bulunan kişi sayısıdır (sunucular, konuşmacılar ve dinleyiciler), şimdiye kadar dinleyen herkesin toplamı değil. Bir Space yalnızca bağlantısıyla okunur, kullanıcı adıyla aranmaz. Bilinmeyen hesap, yayın veya Space 404, gönderileri korumalı bir hesap 403, kullanıcı adı, yayın bağlantısı ya da Space bağlantısı olmayan bir değer 400 döner; hepsi ücretsizdir.

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.