Live Battle (PK)

01Query parameters

02Request

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

03Responses

Real answers from the API. Lists are shortened to 2 items.

{
  "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"
}

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The answer is `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`. The host comes first; in a 1-to-1 PK `team` is `host` or `opponent`. Scores are TikTok's battle points, refreshed by TikTok about every 10 seconds. After a battle ends TikTok keeps it for about a minute with the final scores: `in_battle` is false, `finished` true and the participants are still there. Live without a battle, and not live, are data too (1 credit): `in_battle` false, the battle fields null, `participants` empty. An opponent whose name lookup fails keeps its id and score with null names. An unknown handle or room is a free 404; a missing parameter or a non-numeric `room_id` is a free 400.