1. Live
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Product - Ranking
      • Product - Search V1
      • Product - Search V2
      • Product - Basic Info
      • Product - SKU Info
      • Product - Video List V1
      • Product - Video List V2
      • Product - Video List V3
      • Product - Video Statistics V2
      • Product - Creator List V1
      • Product - Creator List V2
      • Product - Creator List V3
      • Product - Trend
      • Product - Sales Mode Distribution V1
      • Product - Sales Mode Distribution V2
      • Item Sales Channels Distribution
      • Product - Sales Channel Distribution V2
      • Product - Live List V1
      • Product - Live List V2
      • Product - Live List V3
      • Product - Live Statistics V1
      • Item Live Statistics V2
      • Product - Creator Statistics V1
      • Product - Creator Statistics V2
    • Item Creator
      • Creator - Search V1
      • Creator - Search V2
      • Creator - Search V3
      • Creator - Statistics V1
      • Creator - Statistics V2
      • Creator - Basic Info
      • Creator - Product List V1
      • Creator - Product List V2
      • Creator - Product List V3
      • Creator - Product Category V1
      • Item Creator Item Category V2
      • Creator - Product Category V3
      • Creator - Video Trend
      • Creator - Video Category V1
      • Creator - Video Category V2
      • Creator - Video List V1
      • Creator - Video List V2
      • Creator - Affiliate Videos
      • Creator - Trend
      • Item Creator Live List V2
      • Creator AI Insight Metrics
      • Creator - Seller List
    • Seller
      • Seller - Ranking
      • Seller - Search V1
      • Seller - Search V2
      • Seller - Search V3
      • Seller - Basic Info
      • Seller - Statistics V1
      • Seller - Statistics V2
      • Seller - Sales Distribution
      • Seller - Sales Trend
      • Seller - Promotion Trend
      • Seller - Live Data
      • Seller - Category Analysis
      • Seller - Product Category List
      • Seller - Product List V1
      • Seller - Product List V2
      • Seller - Video Category List
      • Seller - Video List
      • Seller - Live List
      • Seller - Creator List V1
      • Seller - Creator List V2
    • Item Video
      • Video - Search V1
      • Video - Search V2
      • Video - Basic Info
      • Video - Period Statistics
      • Video - AI Insight
      • Video - Product List V1
      • Video - Trend
      • Video - Play URL
      • Video - Product List V2
      • Video - Product List V3
    • Category
      • Category - Potential Category
      • Category - Market Trend
      • Category - Top 10 Categories
    • Hashtag
      • Hashtag - Search V1
      • Hashtag - Search V2
      • Hashtag - Ranking
      • Hashtag - Basic Info V1
      • Hashtag - Basic Info V2
      • Hashtag - Trend
      • Hashtag - Creator List
      • Hashtag - Video List V1
      • Hashtag - Video List V2
      • Topic Basic Info V3
    • Live
      • Live - Search
        GET
      • Live - Basic Info
        GET
      • Live - Product Category
        GET
      • Live - Product List V1
        GET
      • Live - Product List V2
        GET
      • Live - Traffic Trend
        GET
    • Data Expand
      • Data Expansion - Manual Update
  • Meta APIs
    • Translation of Item category names
    • Search Blacklist
      • Blacklist - Block
      • Blacklist - Check
      • Blacklist - List
      • Blacklist - Unblock
    • Country List
      GET
    • Item Category List
      GET
    • Metadata - TikTok Category
      GET
    • Metadata - Language List
      GET
    • Metadata - Country List
      GET
    • Metadata - Creator Category V2
      GET
    • Quota - Remaining
      GET
  • Data
    • Item
    • Category
    • Creator
  • Schemas
    • Basic result response
    • Trend series
    • Amount
    • Result response
    • Range
    • Period count
    • Sales distribution
    • Trend count
    • Distribution creator
    • Currency symbol
    • Trend point
    • Period amount
    • Video trend
    • Creator statistics
    • Video trend response
    • Creator statistics list response
  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 '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%3A00%3A00&liveTimeEndHms=04%3A00%3A00&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
Bodyapplication/json

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"
}
🟢200Parameter Error
🟢200Signature Error
🟢200Server Error
Modified at 2026-09-22 07:48:50
Previous
Topic Basic Info V3
Next
Live - Basic Info
Built with