Canlı Yayın Durumu

GET/v1/facebook/user/live1 kredi

Bir Facebook sayfasının ya da profilinin şu anda canlı yayında olup olmadığını ve kaç kişinin izlediğini döndürür; bir video URL'si verilirse o videonun şu anda süren bir canlı yayın olup olmadığını söyler.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Bir Facebook sayfası ya da profil URL'si (örneğin `https://www.facebook.com/aljazeerachannel`, `profile.php?id=…`) veya bir video URL'si (`/<sayfa>/videos/<id>`, `/watch/?v=<id>`, `/reel/<id>`, `fb.watch/…`).

02İstek

curl "https://api.scrapesocial.ai/v1/facebook/user/live?url=https%3A%2F%2Fwww.facebook.com%2Faljazeerachannel" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v1/facebook/user/live?url=https%3A%2F%2Fwww.facebook.com%2Faljazeerachannel

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "facebook",
  "is_live": true,
  "live_id": "1898592764464666",
  "title": "#تغطية_مباشرة | ترمب لفوكس نيوز: سؤالي حاليا هو هل أبرم اتفاقا مع الإيرانيين أم أقضي عليهم نهائيا",
  "started_at": "2026-10-25T15:52:19Z",
  "viewer_count": 371,
  "url": "https://www.facebook.com/aljazeerachannel/videos/1898592764464666/",
  "owner": {
    "id": "100064654032648",
    "username": "aljazeerachannel",
    "display_name": "Al Jazeera Channel - قناة الجزيرة"
  }
}

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

Bu uç nokta bize özgüdür: ScrapeCreators'ta Facebook için canlı yayın uç noktası yoktur. Yanıt her platformun canlı yayın uç noktasında aynıdır: `platform`, `is_live`, `live_id`, `title`, `started_at` (ISO-8601 UTC), `viewer_count`, `url` ve `owner` (`id`, `username`, `display_name`). Canlı yayında olmayan bir sayfa da veridir: sahibi dolu, yayın alanları null olarak `is_live: false` döner ve 1 kredi tutar. Facebook'un göstermediği bir değer null'dır (bir reels videosunun sahibinde `username` yoktur). Bilinmeyen bir sayfa `accountDoesNotExist: true` ile ücretsiz bir 404, bilinmeyen bir video ücretsiz bir 404 döndürür.

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.