For AI

Object

LiveStreamer object

A streamer's live figures over a period, as a live board or a creator marketplace shows them: rank, sessions, viewers and sales bands. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

FieldTypeFrom viewDescription
idstringcompactThe streamer's ID on the board's source: the Xingtu creator ID on Douyin (what douyin.live.streamers.metrics takes), the user ID on TikTok.
urlstring | nullcompactThe streamer's page, where there is one.
usernamestring | nullcompactHandle, where the board gives one.
namestring | nullcompactDisplay name; null where the source gives none (douyin.live.streamers.metrics).
avatar_urlstring | nullstandardAvatar image URL.
followersinteger | nullcompactFollowers.
rankinteger | nullcompactPlace on the board, from 1; null outside boards.
scorenumber | nullstandardThe board's score: TikTok's points, or Xingtu's score from 0 to 1.
categorystring | nullcompactContent or product category, in the platform's words.
room_idstring | nullstandardThe room the streamer is live in now, where the board gives it.
daysinteger | nullcompactDays the figures cover; null when the board does not say.
sessionsinteger | nullcompactLive sessions in the period.
avg_viewsinteger | nullcompactAverage views a session.
avg_unique_viewersinteger | nullstandardAverage people who watched a session.
avg_viewersinteger | nullcompactAverage people watching at once.
peak_viewersinteger | nullstandardMost people watching at once.
avg_watch_secondsinteger | nullstandardAverage seconds a viewer stayed.
new_followersinteger | nullcompactFollowers gained live in the period.
engagement_rateBand | nullstandardEngagement rate as the platform works it out, 0 to 1, as a band.
gmvBand | nullcompactSales over the period, in yuan, as a band.
avg_gmvBand | nullcompactAverage sales a session, in yuan, as a band.
gpmBand | nullstandardSales per thousand views (GPM), in yuan, as a band.
avg_priceBand | nullstandardAverage price of the products sold, in yuan, as a band.
productsinteger | nullcompactProducts sold live in the period.
extobjectfullPlatform-specific extras. Only returned with view=full. · only with view=full

Band

FieldTypeDescription
minnumber | nullLow end of the band; null when open-ended ("< 400").
maxnumber | nullHigh end of the band; null when open-ended ("> 0.95").

Endpoints that return a LiveStreamer

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp