1. Item Video
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
        GET
      • Video - Search V2
        GET
      • Video - Basic Info
        GET
      • Video - Period Statistics
        GET
      • Video - AI Insight
        GET
      • Video - Product List V1
        GET
      • Video - Trend
        GET
      • Video - Play URL
        GET
      • Video - Product List V2
        GET
      • Video - Product List V3
        GET
      • Video - Realtime Insight
        GET
    • 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
      • Live - Basic Info
      • Live - Product Category
      • Live - Product List V1
      • Live - Product List V2
      • Live - Traffic Trend
    • 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. Item Video

Video - Realtime Insight

Developing
GET
/api/item_video/realtime_insight
Get realtime video metrics and audience insight.
Rate limit: 1 request every 5 seconds per customer (header x-appKey)
videoInfo: read from the database first; if the video is missing, request it in realtime and cache the result for 60 seconds
insightInfo: request it in realtime and cache the result for 60 seconds
If either part fails to load, that object is omitted

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/item_video/realtime_insight?videoId=7634867395718352148' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": "200",
    "message": "成功!",
    "result": {
        "videoId": "7634867395718352148",
        "videoInfo": {
            "playCount": 113770,
            "likeCount": 540,
            "commentCount": 32,
            "shareCount": 15,
            "engageRate": 0.0052,
            "videoTitle": "string",
            "createTime": "2026-05-01 18:24:58",
            "duration": 49
        },
        "insightInfo": {
            "videoUv": 58380,
            "avgVideoViews": 1.95,
            "avgVideoDurationTime": 4.98,
            "videoFinish": 0.0107,
            "videoNewFollowers": 8,
            "videoViewerFemalePercent": [
                {
                    "date": "string",
                    "score": 0
                }
            ],
            "agePercent": [
                {
                    "date": "string",
                    "score": 0
                }
            ],
            "videoViewerFollowerPercent": [
                {
                    "date": "string",
                    "score": 0
                }
            ],
            "videoViewerReturnPercent": [
                {
                    "date": "string",
                    "score": 0
                }
            ],
            "videoLocationPercentRegions": [
                {
                    "country_name": "string",
                    "country_percent": 0,
                    "city_percent_list": [
                        {
                            "key": "string",
                            "value": 0
                        }
                    ]
                }
            ]
        }
    },
    "serverTime": "2026-10-16 16:09:43"
}
Modified at 2026-10-16 08:49:27
Previous
Video - Product List V3
Next
Category - Potential Category
Built with