1. Live
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Item Ranking
      • Item Search
      • Item - Search V2
      • Item Basic
      • Item Specifications
      • Item Video List
      • Item Video List V2
      • Item Video List V3
      • Item Video Statistics V2
      • Item Creator List
      • Item Creator List V2
      • Item Creator List V3
      • 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 Room List V3
      • 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 Search V3
      • Item Creator Statistic
      • Item Creator Statistic V2
      • Item Creator Basic
      • Item Creator Items
      • Item Creator Items V2
      • Item Creator Items V3
      • Item Creator Item Category
      • Item Creator Item Category V2
      • Item Creator Item Category V3
      • 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
      • Item Creator Seller List
    • Seller
      • Seller Ranking
      • Seller Search
      • Seller Search V2
      • Seller - Search V3
      • Seller - Basic Info
      • Seller - Statistics
      • Seller - Statistics V2
      • Seller - Sales Distribution
      • Sales Trend Analysis
      • Video/Live Promotion Trend Analysis
      • Live Streaming Detailed Data
      • Category Analysis
      • Product Category List
      • Seller - Item List V1
      • Seller - Item List V2
      • Video Category List
      • Video List
      • Live Streaming List
      • Seller - Creator List V1
      • Seller - Creator List V2
    • Item Video
      • Video Search
      • Video - Search V2
      • Item Video Basic
      • Video - Period Statistics
      • AI Insight
      • Item Video Item List
      • Item Video Trend
      • Item Video Play Url
      • Item Video Item List V2
      • Item Video Item List V3
    • Category
      • Category - Potential Categories
      • Category - Market GMV Trend
      • Category - Top10 Categories
    • Hashtag
      • Hashtag Search
      • Hashtag Search V2
      • Topic Rank
      • Topic Basic Info
      • Topic Basic Info V2 (Period Aggregation)
      • Topic Usage Trend
      • Topic Associated Creator List
      • Topic Associated Video list
      • Topic Associated Video list V2
    • Live
      • Live Room Search
        GET
      • Live Room Basic Information
        GET
      • Product Category List
        GET
      • Product List
        GET
      • Product List V2
        GET
      • Live Room Trend
        GET
    • Data Expand
      • Data Expand - Manual Update
  • Meta APIs
    • Translation of Item category names
    • Country List
      GET
    • Item Category List
      GET
    • Tiktok Category List
      GET
    • Metadata - Language List
      GET
    • Metadata - Country List
      GET
  • Data
    • Live
    • Item
  • 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 Room Basic Information

GET
/api/live/basic
Retrieve basic information of a live stream

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/basic?roomId=7456789012345678901' \
--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": "Success!",
  "result": {
    "roomInfo": {
      "roomName": "Fashion Friday Live",
      "roomId": "7456789012345678901",
      "updateTime": "2026-04-09T22:05:00",
      "roomCreateTime": "2026-04-09T20:00:00",
      "roomEndTime": "2026-04-09T22:00:00",
      "liveDuration": 7200,
      "roomCoverUrl": "https://cdn.example.com/covers/room1.jpg",
      "roomRegion": "US",
      "roomRegionCommentZh": "美国",
      "roomRegionCommentEn": "United States"
    },
    "authorInfo": {
      "authorAvatarUrl": "https://cdn.example.com/avatars/author1.jpg",
      "authorUid": "6812345678901234567",
      "authorName": "FashionGuru",
      "uniqueId": "fashionguru_official",
      "signature": "Fashion & Lifestyle Creator",
      "region": "US",
      "regionCommentZh": "美国",
      "regionCommentEn": "United States",
      "followerCountTotal": 580000,
      "videoCountTotal": 320
    },
    "flowData": {
      "totalUser": 35600,
      "maxOnlineUser": 1250,
      "avgOnlineUser": 620,
      "followerCountPeriod": 1820,
      "followerTransRate": 0.0512
    },
    "transactionData": {
      "localGmvPeriod": 45680.50,
      "localPriceCurrency": "USD",
      "localPriceSymbol": "$",
      "soldCountPeriod": 1820,
      "localAvgTransactionPrice": 25.10,
      "bagTotal": 58,
      "soldTransRate": 0.0512,
      "revenuePerThousandPlays": 1283.16,
      "liveOrderConversionRate": 0.0321
    },
    "categoryComposition": [
      {
        "categoryId": "600024",
        "categoryName": "Fashion",
        "rank": 1,
        "rate": 0.65,
        "itemCateSoldCountPeriod": 1183,
        "roomCateItemCount": 38,
        "roomCateLocalGmvPeriod": 29692.33,
        "roomCateRmbGmvPeriod": null,
        "roomCateUsdGmvPeriod": 29692.33
      }
    ],
    "categoryGmvComposition": [
      {
        "categoryId": "600024",
        "categoryName": "Fashion",
        "rank": 1,
        "rate": 0.65,
        "itemCateSoldCountPeriod": 1183,
        "roomCateItemCount": 38,
        "roomCateLocalGmvPeriod": 29692.33,
        "roomCateRmbGmvPeriod": null,
        "roomCateUsdGmvPeriod": 29692.33
      }
    ],
    "userCountComposition": {
      "myFollow": 0.42,
      "other": 0.38,
      "videoDetail": 0.20
    }
  },
  "serverTime": "2026-04-09 10:53:25"
}
Modified at 2026-04-23 03:16:52
Previous
Live Room Search
Next
Product Category List
Built with