Item Live Room List V3 - Tabcut Open API

Retrieve the list of live streams associated with a specific item within a given date range. Supports sorting by live start time, total viewers, sales volume, sales amount, conversion rate, and revenue per 1,000 views. V3 adds the revenue per 1,000 views field.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

json

Body

Example

{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": {
            "soldCountPeriod": 0,
            "roomList": [
                {
                    "roomId": "string",
                    "roomName": "string",
                    "liveDuration": 0,
                    "roomCoverUrl": "string",
                    "authorAvatarUrl": "string",
                    "authorUid": "string",
                    "authorName": "string",
                    "uniqueId": "string",
                    "followerCountTotal": 0,
                    "roomCreateTime": "string",
                    "totalUser": 0,
                    "liveItemSoldCountPeriod": 0,
                    "liveRoomGmvInfo": {
                        "periodCurrent": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "soldTransRate": 0,
                    "liveRevenuePerThousandViewsInfo": {
                        "periodCurrent": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "currencySymbolInfo": {
                        "local": "string",
                        "region": "string"
                    }
                }
            ]
        }
    },
    "serverTime": "2026-02-05 10:53:25"
}