Real run · 2026-11-09 · 2 records

TikTok Live Live status API

Live status from TikTok Live, returned as JSON rows you can save to CSV.

Resultready
JSON
2records in this run
18fields per record
5srun time, start to finish
$0.004per record, Bronze tier
Request

The input that produced this run

Mode liveStatus. Parameters as sent, with what each one does.

ParameterValueWhat it does
mode"liveStatus"What to scrape: live rooms found by keyword, whether given users or rooms are live right now, the daily ranking of top live creators, or the top gifters of a live room.
users["@tyler_river", "@khaby.lame"]TikTok handles (@name or name), profile links or live links such as https://www.tiktok.com/@name/live. Short links are not supported. In liveGifters a user must be live; each user pays its own start fee.
maxResults10Maximum records for each keyword (liveSearch) or each room (liveGifters), up to 1000; for liveStatus the maximum number of users and rooms checked; for liveRanking the maximum rows (the ranking holds 99). A room...
Response fields

18 fields in every liveStatus

From the first record of the run above. Identity fields of ordinary users are masked on this site.

FieldTypeExample
typestrliveStatus
inputstr@tyler_river
isLiveboolfalse
statusstroffline
roomIdnullnull
titlenullnull
viewerCountnullnull
totalViewersnullnull
startedAtnullnull
coverUrlnullnull
hostUserIdstr<masked>
hostHandlestr<masked>
hostNicknamestr<masked>
hostVerifiedboolfalse
hostFollowerCountint877388
hostFollowingCountint10000
hostAvatarUrlstr<masked>
liveUrlstrhttps://www.tiktok.com/@tyler_river/live
Sample output

A real run, 18 fields per record

Run on 2026-11-09 with input {"mode": "liveStatus", "users": ["@tyler_river", "@khaby.lame"], "maxResults": 10}. Personal fields of ordinary users are masked here.

inputstatushostFollowerCounthostFollowingCount
@tyler_riveroffline87738810000
@khaby.lameoffline16294821282
All 18 fields in one record
  • type liveStatus
  • input @tyler_river
  • isLive
  • status offline
  • roomId
  • title
  • viewerCount
  • totalViewers
  • startedAt
  • coverUrl
  • hostUserId
  • hostHandle
  • hostNickname
  • hostVerified
  • hostFollowerCount 877388
  • hostFollowingCount 10000
  • hostAvatarUrl
  • liveUrl https://www.tiktok.com/@tyler_river/live
Pricing

What one liveStatus costs

Live room (liveSearch) or status record (liveStatus) · $0.004

Full TikTok Live price table and calculator

Developers

Run this request yourself

The same input as above, three ways.

Request
Response · 200application/json

Run it with your own input

Two free trial runs, no card needed.

Open on Apify

All TikTok Live requests