Tabcut Open API
  1. Live
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Item Ranking
      • Item Search
      • Item Basic
      • Item Specifications
      • Item Video List
      • Item Video List V2
      • Item Video Statistics V2
      • Item Creator List
      • Item Creator List V2
      • Item Trend
      • Item Sales Mode Distribution
      • Item Sales Mode Distribution V2
      • Item Sales Channels Distribution
      • Item Sales Channels Distribution V2
      • Item Live Room List
      • Item Live Room List V2
      • Item Live Statistics
      • Item Live Statistics V2
      • Item Creator Statistics
      • Item Creator Statistics V2
    • Item Creator
      • Item Creator Search
      • Item Creator Search V2
      • Item Creator Statistic
      • Item Creator Basic
      • Item Creator Items
      • Item Creator Items V2
      • Item Creator Item Category
      • Item Creator Item Category V2
      • Item Creator Video Trend
      • Item Creator Video Category
      • Item Creator Video Category V2
      • Item Creator Video List
      • Item Creator Video List V2
      • Item Creator Video Detail
      • Item Creator Trend
      • Item Creator Live List V2
      • Creator AI Insight Metrics
    • Seller
      • Seller Ranking
      • Seller Search
      • Seller Search V2
      • Seller - Basic Info
      • Seller - Statistics
      • Seller - Sales Distribution
      • Sales Trend Analysis
      • Video/Live Promotion Trend Analysis
      • Live Streaming Detailed Data
      • Category Analysis
      • Product Category List
      • Product List
      • Video Category List
      • Video List
      • Live Streaming List
      • Creator List
    • Item Video
      • Video Search
      • Item Video Basic
      • AI Insight
      • Item Video Item List
      • Item Video Trend
      • Item Video Play Url
      • Item Video Item List V2
    • Category
      • Potential Category List
    • Hashtag
      • Hashtag Search
      • Topic Rank
      • Topic Basic Info
      • Topic Usage Trend
      • Topic Associated Creator List
      • Topic Associated Video list
    • Live
      • Live Search
        GET
      • Live Room Basic
        GET
      • Product Category List
        GET
      • Product List
        GET
      • Live Room Trend
        GET
  • Meta APIs
    • Translation of Item category names
    • Country List
      GET
    • Item Category List
      GET
    • Tiktok Category List
      GET
  • Schemas
    • 通用response结构
    • 通用趋势数据元素结构
    • GMVInfoVO
    • ResultResponse?
    • RangeVO
    • CountVO
    • DistributionVO
    • TrendElementVOLong
    • sales distribution Creator info
    • Currency Symbol Info
    • TrendElementVOBigDecimal
    • CurrencySymbolVO
    • GmvAmountVO
    • GmvInfoVO
    • VideoTrendVO
    • OpenApiCreatorStatisticVO
    • ResultResponseVideoTrendVO
    • ResultResponseListOpenApiCreatorStatisticVO
  1. Live

Live Search

GET
/api/live/search
Search for live streams with various filters (date format: yyyyMMdd)

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://open.tabcut.com:8090/api/live/search?roomName&region&itemCategoryId&followerCountBegin&followerCountEnd&roomCreateBeginDs&roomCreateEndDs&sortField&sortOrder&pageNo&pageSize' \
--header 'x-appKey;' \
--header 'x-timestamp;' \
--header 'x-sign;' \
--header 'x-selected-lng;'

Responses

🟢200OK
application/json
Successful response
Body

Example
{
    "code": "200",
    "message": "成功!",
    "result": {
        "total": 36,
        "pageNo": 1,
        "pageSize": 2,
        "data": [
            {
                "roomId": "7589046174108125969",
                "roomName": "トクトクセール 大感謝抽選会",
                "liveDuration": 9225,
                "roomCoverUrl": "https://cdn.tabcut.com/dataservice/media/live/7589046174108125969/cover.jpg?x-oss-process=image/resize,w_246,h_246/format,webp",
                "authorAvatarUrl": "https://cdn.tabcut.com/dataservice/media/user/7273111224622515207/avatar.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "authorUid": "7273111224622515207",
                "authorName": "まるかん行橋店ナースの青汁屋さん",
                "uniqueId": "hisako13_20",
                "authorRegion": "JP",
                "authorRegionCommentZh": "Japan",
                "authorRegionCommentEn": "日本",
                "followerCountTotal": 2509,
                "roomCreateTime": "2025-12-29 06:55:45",
                "roomFinishTime": "2025-12-29 09:29:30",
                "totalUser": 1431,
                "liveRoomSoldCountPeriod": 3,
                "liveRoomLocalGmvPeriod": 86940.00,
                "bagTotal": 49,
                "soldTransRate": null,
                "liveRoomGmvInfo": {
                    "periodCurrent": {
                        "local": 86940.00,
                        "region": 588.58
                    }
                },
                "currencySymbolInfo": {
                    "local": "¥",
                    "region": "$"
                },
                "categoryList": [
                    {
                        "categoryName": "保健",
                        "id": 9,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "700645"
                    },
                    {
                        "categoryName": "美妆个护",
                        "id": 2,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "601450"
                    },
                    {
                        "categoryName": "食品饮料",
                        "id": 7,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "700437"
                    },
                    {
                        "categoryName": "图书&杂志&音频",
                        "id": 3,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "801928"
                    },
                    {
                        "categoryName": "其他",
                        "id": 10000,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "10000"
                    }
                ]
            },
            {
                "roomId": "7589418454625569553",
                "roomName": "トクトクセール 大感謝抽選会",
                "liveDuration": 11140,
                "roomCoverUrl": "https://cdn.tabcut.com/dataservice/media/live/7589418454625569553/cover.jpg?x-oss-process=image/resize,w_246,h_246/format,webp",
                "authorAvatarUrl": "https://cdn.tabcut.com/dataservice/media/user/7273111224622515207/avatar.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "authorUid": "7273111224622515207",
                "authorName": "まるかん行橋店ナースの青汁屋さん",
                "uniqueId": "hisako13_20",
                "authorRegion": "JP",
                "authorRegionCommentZh": "Japan",
                "authorRegionCommentEn": "日本",
                "followerCountTotal": 2509,
                "roomCreateTime": "2025-12-30 07:00:11",
                "roomFinishTime": "2025-12-30 10:05:51",
                "totalUser": 4795,
                "liveRoomSoldCountPeriod": 13,
                "liveRoomLocalGmvPeriod": 85680.00,
                "bagTotal": 48,
                "soldTransRate": null,
                "liveRoomGmvInfo": {
                    "periodCurrent": {
                        "local": 85680.00,
                        "region": 580.05
                    }
                },
                "currencySymbolInfo": {
                    "local": "¥",
                    "region": "$"
                },
                "categoryList": [
                    {
                        "categoryName": "食品饮料",
                        "id": 7,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "700437"
                    },
                    {
                        "categoryName": "美妆个护",
                        "id": 2,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "601450"
                    },
                    {
                        "categoryName": "保健",
                        "id": 9,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "700645"
                    },
                    {
                        "categoryName": "其他",
                        "id": 10000,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "10000"
                    },
                    {
                        "categoryName": "图书&杂志&音频",
                        "id": 3,
                        "pid": 0,
                        "region": "CN",
                        "level": 1,
                        "tkCategoryId": "801928"
                    }
                ]
            }
        ]
    },
    "serverTime": "2026-01-07 17:12:31"
}
Modified at 2026-01-07 09:15:04
Previous
Topic Associated Video list
Next
Live Room Basic
Built with