Canlı Yayın Odası

GET/v1/tiktok/live1 kredi

Kimliği verilen bir TikTok canlı yayın odasını döndürür: başlık, kapak, beğeni ve izleyici sayıları, durum ve yayıncı.

01Sorgu parametreleri

Ad	Tür	Açıklama
room_idzorunlu	string	Canlı yayın odasının sayısal kimliği (User Live Status yanıtındaki `roomId`).
user_idisteğe bağlı	string	Yayıncının kullanıcı kimliği. Uyumluluk için kabul edilir; gerekli değildir.

02İstek

curl "https://api.scrapesocial.ai/v1/tiktok/live?room_id=7523685855395842871" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v1/tiktok/live?room_id=7700625972861324065

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "room_id": "7700625972861324065",
  "like_count": 0,
  "viewer_count": 5,
  "status": 2,
  "title": "",
  "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d58764c4552bc4800c6bb20740590c50~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=a8c18134&x-expires=1793120400&x-signature=%2BKag3Sk7d8xu3JvmCs40Nj7PPFw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2",
  "owner": {
    "id": "7308031192074126369",
    "username": "babagaming_22",
    "display_name": "BABA GAMING"
  }
}

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 `room_id`, `like_count`, `viewer_count`, `status`, `title`, `cover_url` ve `owner` (`id`, `username`, `display_name`) alanlarından oluşur. Sona ermiş bir oda da (`status` değeriyle) döndürülür ve 1 kredi tutar. Sayısal olmayan bir `room_id` ücretsiz 400, bilinmeyen bir oda ü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.