Unofficial TikTok API — Live Stats

GET/api/v1/live_stats

A creator's live-centre stats: live status, fans club and gifts, and the full broadcast history with per-stream likes and duration, plus a summary.

ParameterDescription
usernameoptionalTikTok username, @handle, or profile URL. (Use this OR user_id.)
user_idoptionalThe numeric TikTok user id (from /profile → data.user.id). (Use this OR username.)
history_limitoptionalReturn only the N most recent broadcasts. Defaults to all.

Returns

username, user_id, anchor (nickname, bio, avatar_url), is_live, room_id, fans_club (count, level), gifts (total, lighted, sponsored), summary (broadcasts, total_likes, total_minutes, average_likes, best), and history — each entry with room_id, title, started_at, ended_at, duration_minutes, likes.

Example Request

https://dev.omar-thing.site/api/v1/live_stats?username=tiktok&user_id=107955&history_limit=20&key=YOUR_API_KEY

Example Response

{
  "data": {
    "anchor": {
      "avatar_url": "https://p16-common-sign.tiktokcdn.com/.../avatar.webp",
      "bio": "live every evening",
      "nickname": "Some Creator"
    },
    "fans_club": {
      "count": 4200,
      "level": 12
    },
    "gifts": {
      "lighted": 3,
      "sponsored": false,
      "total": 38
    },
    "history": [
      {
        "duration_minutes": 220,
        "ended_at": 1790286078,
        "likes": 131000,
        "room_id": "7460000000000000000",
        "started_at": 1790272844,
        "title": "come hang out"
      },
      {
        "duration_minutes": 225,
        "ended_at": 1787029918,
        "likes": 310000,
        "room_id": "7460000000000000001",
        "started_at": 1787016414,
        "title": "big night"
      },
      {
        "...": "older broadcasts",
        "room_id": "...",
        "title": "..."
      }
    ],
    "is_live": true,
    "room_id": "7460000000000000000",
    "summary": {
      "average_likes": 45000,
      "best": {
        "duration_minutes": 225,
        "ended_at": 1787029918,
        "likes": 310000,
        "room_id": "7460000000000000001",
        "started_at": 1787016414,
        "title": "big night"
      },
      "broadcasts": 120,
      "total_likes": 5400000,
      "total_minutes": 18600
    },
    "user_id": "6700000000000000000",
    "username": "someuser"
  },
  "status": "success"
}
Sends a live request using your API key above.

More Live endpoints