LIVE audience
The online audience ranking.
Upstream
/webcast/ranklist/online_audience/Every planParameters
| Name | Type | Description |
|---|---|---|
room_idrequired | string | The numeric LIVE room ID. e.g. 7705861000123456789 |
Pricing
| Plan | Per call | Per 1,000 calls |
|---|---|---|
| Starter | 10 credits | $1.16 |
| Growth | 10 credits | $0.79 |
| Scale | 10 credits | $0.58 |
Responses
A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes
curl -G https://api.tikultra.com/v1/live/audience \
-H "x-api-key: $TIKULTRA_KEY" \
--data-urlencode "room_id=7705861000123456789"{
"room_id": "7705861000123456789",
"online_count": 1842,
"contributors": [
{
"rank": 1,
"user": {
"unique_id": "deskminimal",
"nickname": "Desk Minimal"
},
"score_diamonds": 1450
},
{
"rank": 2,
"user": {
"unique_id": "kbfan",
"nickname": "KB Fan"
},
"score_diamonds": 620
}
]
}More in LIVE rooms
GET/v1/live/roomLIVE room10 crGET/v1/live/check-aliveIs LIVE5 crGET/v1/live/chatLIVE chat10 crGET/v1/live/with-chatLIVE room with chat10 crGET/v1/live/streamLIVE stream URLs10 crGET/v1/live/rankingLIVE hourly ranking10 crGET/v1/live/giftsLIVE gift catalog10 crGET/v1/live/recommendedRecommended LIVE10 crGET/v1/live/goody-bagGoody bag10 crGET/v1/live/bag-itemsLIVE bag items10 cr
Ready to build?
Start with 2,500 free credits and test every public endpoint, then pick a plan.