Live Room Search - Tabcut Open API

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'http://open.tabcut.com:8090/api/live/search?roomName=fashion&region=US&itemCategoryId=600024&followerCountBegin=10000&followerCountEnd=1000000&roomCreateBeginDs=20260401&roomCreateEndDs=20260409&roomLocalGmvBegin=100&roomLocalGmvEnd=999999&roomAvgPriceBegin=10&roomAvgPriceEnd=500&sellerCountType=1&liveTimeStartHms=02:00:00&liveTimeEndHms=04:00:00&sortField=roomSoldCount&sortOrder=desc&pageNo=1&pageSize=10' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: ja-JP'

Responses

🟢200Success

application/json

Body

Example

{
  "code": "200",
  "message": "成功!",
  "result": {
    "total": 1526,
    "pageNo": 1,
    "pageSize": 2,
    "data": [
      {
        "roomId": "7456789012345678901",
        "roomName": "Fashion Friday Live",
        "liveDuration": 7200,
        "roomCoverUrl": "https://cdn.example.com/covers/room1.jpg",
        "authorAvatarUrl": "https://cdn.example.com/avatars/author1.jpg",
        "authorUid": "6812345678901234567",
        "authorName": "FashionGuru",
        "uniqueId": "fashionguru_official",
        "authorRegion": "US",
        "authorRegionCommentZh": "美国",
        "authorRegionCommentEn": "United States",
        "followerCountTotal": 580000,
        "roomCreateTime": "2026-04-09 20:00:00",
        "roomFinishTime": "2026-04-09 22:00:00",
        "totalUser": 35600,
        "liveRoomSoldCountPeriod": 1820,
        "liveRoomLocalGmvPeriod": 45680.50,
        "bagTotal": 58,
        "soldTransRate": 0.0512,
        "revenuePerThousandPlays": 1283.16,
        "avgUserCount": 620.5,
        "liveConversionRate": 0.0512,
        "liveOrderConversionRate": 0.0321,
        "sellerCount": 3,
        "top3ItemList": [
          {
            "itemId": "1729384756012345678",
            "itemName": "Summer Floral Dress",
            "itemCoverUrl": "https://cdn.example.com/items/dress1.jpg",
            "sellerId": "7300000000000001",
            "localGmv": "12560.00",
            "localSkuMinPrice": "29.99",
            "rn": 1
          },
          {
            "itemId": "1729384756012345679",
            "itemName": "Casual Sneakers",
            "itemCoverUrl": "https://cdn.example.com/items/shoes1.jpg",
            "sellerId": "7300000000000002",
            "localGmv": "8930.00",
            "localSkuMinPrice": "49.99",
            "rn": 2
          },
          {
            "itemId": "1729384756012345680",
            "itemName": "Vintage Sunglasses",
            "itemCoverUrl": "https://cdn.example.com/items/glasses1.jpg",
            "sellerId": "7300000000000001",
            "localGmv": "6200.00",
            "localSkuMinPrice": "15.99",
            "rn": 3
          }
        ],
        "liveRoomGmvInfo": {
          "periodCurrent": {
            "local": 45680.50,
            "region": null
          }
        },
        "currencySymbolInfo": {
          "local": "$",
          "region": null
        },
        "categoryList": [
          {
            "categoryName": "Womenswear",
            "id": 1,
            "pid": null,
            "region": "US",
            "level": 1,
            "tkCategoryId": "600024"
          }
        ]
      },
      {
        "roomId": "7456789012345678902",
        "roomName": "Japan Beauty Live",
        "liveDuration": 5400,
        "roomCoverUrl": "https://cdn.example.com/covers/room2.jpg",
        "authorAvatarUrl": "https://cdn.example.com/avatars/author2.jpg",
        "authorUid": "6812345678901234568",
        "authorName": "BeautyJP",
        "uniqueId": "beautyjp_live",
        "authorRegion": "JP",
        "authorRegionCommentZh": "日本",
        "authorRegionCommentEn": "Japan",
        "followerCountTotal": 320000,
        "roomCreateTime": "2026-04-09 19:00:00",
        "roomFinishTime": null,
        "totalUser": 18200,
        "liveRoomSoldCountPeriod": 960,
        "liveRoomLocalGmvPeriod": 3850000.00,
        "bagTotal": 32,
        "soldTransRate": 0.0527,
        "revenuePerThousandPlays": 211538.46,
        "avgUserCount": 410.2,
        "liveConversionRate": 0.0527,
        "liveOrderConversionRate": 0.0298,
        "sellerCount": 1,
        "top3ItemList": null,
        "liveRoomGmvInfo": {
          "periodCurrent": {
            "local": 3850000.00,
            "region": null
          }
        },
        "currencySymbolInfo": {
          "local": "¥",
          "region": null
        },
        "categoryList": []
      }
    ]
  },
  "serverTime": "2026-04-09 10:53:25"
}