Canlı Yayın Düellosu (PK)

GET/v1/tiktok/live/battle1 kredi

Bir TikTok LIVE odasının şu anda bir düelloda (PK) olup olmadığını söyler; düellonun kimliğini, başlangıç zamanını, süresini ve katılımcılarını döndürür: her yayıncının kullanıcı kimliği, kullanıcı adı, görünen adı ve anlık puanı. Bize ait bir rota: ScrapeCreators'ta düello rotası yoktur.

01Sorgu parametreleri

Ad	Tür	Açıklama
handleisteğe bağlı	string	Yayıncının TikTok kullanıcı adı (`@` ve profil URL'leri okunur). Önce o anki canlı yayın odası bulunur. `handle` ya da `room_id` parametrelerinden biri gereklidir.
room_idisteğe bağlı	string	Canlı yayın odasının sayısal kimliği (User Live Status yanıtındaki `roomId`). `handle` ile birlikte verilirse bu kullanılır ve bir çağrı daha hızlıdır.

02İstek

curl "https://api.scrapesocial.ai/v1/tiktok/live/battle?handle=babagaming_22" \
  -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/battle?room_id=7700625972861324065

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "room_id": "7700625972861324065",
  "owner": {
    "id": "7308031192074126369",
    "username": "babagaming_22",
    "display_name": "BABA GAMING"
  },
  "is_live": true,
  "in_battle": false,
  "battle_id": null,
  "mode": null,
  "started_at": null,
  "duration_seconds": null,
  "finished": null,
  "participants": [],
  "fetched_at": "2026-10-25T17:10:30Z"
}

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, owner{id, username, display_name}, is_live, in_battle, battle_id, mode (pk / multi_guest / unknown), started_at, duration_seconds, finished, participants[{user_id, username, display_name, score, team}], fetched_at` alanlarından oluşur. Oda sahibi ilk sıradadır; bire bir PK'da `team` değeri `host` ya da `opponent` olur. Puanlar TikTok'un düello puanlarıdır ve TikTok tarafından yaklaşık 10 saniyede bir güncellenir. Düello bittikten sonra TikTok onu son puanlarla yaklaşık bir dakika daha tutar: `in_battle` false, `finished` true olur ve katılımcılar yerinde kalır. Düellosuz canlı yayın ve yayında olmama da veridir (1 kredi): `in_battle` false, düello alanları null, `participants` boş olur. Adı alınamayan bir rakip, kimliği ve puanıyla birlikte null adlarla döner. Bilinmeyen bir kullanıcı adı ya da oda ücretsiz 404; eksik parametre ya da sayısal olmayan bir `room_id` ücretsiz 400 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.