Canlı Yayın Durumu

GET/v1/instagram/user/live1 kredi

Bir hesabın şu anda canlı yayında olup olmadığını, yayındaysa yayının id'sini, başlığını, başlama zamanını, anlık izleyici sayısını ve izleme adresini döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
user_idisteğe bağlı	string	Sayısal Instagram kullanıcı id'si. `user_id` ya da `handle` parametrelerinden biri zorunludur. İkisi birlikte verilirse `handle` kullanılır.
handleisteğe bağlı	string	Instagram kullanıcı adı (başında `@` ya da profil URL'si de olabilir). `user_id` ya da `handle` parametrelerinden biri zorunludur.

02İstek

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

03Yanıtlar

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

GET /v1/instagram/user/live?handle=alarabiya

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "instagram",
  "is_live": false,
  "live_id": null,
  "title": null,
  "started_at": null,
  "viewer_count": null,
  "url": null,
  "owner": {
    "id": "971184598",
    "username": "alarabiya",
    "display_name": "العربية Al Arabiya"
  }
}

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

Bize ait bir endpoint: ScrapeCreators'ta Instagram canlı yayın endpoint'i yok. Yanıt, her platformun canlı yayın endpoint'inde aynıdır: `platform`, `is_live`, `live_id`, `title`, `started_at` (ISO 8601, UTC), `viewer_count`, `url` ve `owner` (`id`, `username`, `display_name`). Hesap canlı yayında olsun ya da olmasın yanıt 1 kredidir; canlı yayında değilse `is_live` `false` olur, `owner` doludur ve yayın alanları `null` döner. Instagram'ın vermediği bir değer 0 değil `null` olur. Gizli hesap ücretsiz 403, bulunamayan hesap ücretsiz 404 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.