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 - Basic Info

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 'http://open.tabcut.com:8090/api/live/basic?roomId=7456789012345678901' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success
application/json
Bodyapplication/json

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"
}
🟢200Parameter Error
🟢200Signature Error
🟢200Server Error
Modified at 2026-09-22 07:52:10
Previous
Live - Search
Next
Live - Product Category
Built with