Item Video List V3 - Tabcut Open API

Retrieve the related video list for an item detail page (V3). Supports filtering by video publish date range. New metrics include video conversion rate and revenue per thousand plays. Sort fields use camelCase and support both ascending and descending order.
Request Code Samples
Shell
JavaScript
Java
Swift
PHP
Python
HTTP
Objective-C
Ruby
OCaml
Dart
Responses
🟢200Success
json
Body
Example
{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "videoInfo": {
                    "videoId": "string",
                    "videoCoverUrl": "string",
                    "videoUrl": "string",
                    "videoDesc": "string",
                    "hashtags": [
                        {
                            "hashtagId": "string",
                            "hashtagName": "string"
                        }
                    ],
                    "videoDuration": 0,
                    "discoverTime": 0,
                    "createTime": 0,
                    "updateTime": 0,
                    "originVideoUrl": "string",
                    "tkVideoUrl": "string",
                    "region": "string",
                    "playCountInfo": {
                        "periodCurrent": 0,
                        "period1d": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "period90d": 0,
                        "period180d": 0,
                        "period365d": 0,
                        "prePeriod1d": 0,
                        "prePeriod7d": 0,
                        "prePeriod30d": 0,
                        "total": 0,
                        "avg": 0,
                        "video": 0,
                        "live": 0,
                        "totalFromStart": 0
                    },
                    "likeCountInfo": {
                        "periodCurrent": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "total": 0,
                        "avg": 0,
                        "totalFromStart": 0
                    },
                    "shareCountInfo": {
                        "periodCurrent": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "total": 0,
                        "avg": 0
                    },
                    "commentCountInfo": {
                        "periodCurrent": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "total": 0,
                        "avg": 0
                    },
                    "soldCountInfo": {
                        "periodCurrent": 0,
                        "total": 0
                    },
                    "currencySymbolInfo": {
                        "local": "string",
                        "region": "string"
                    },
                    "gmvInfo": {
                        "periodCurrent": {
                            "local": 0,
                            "region": 0
                        },
                        "period7d": {
                            "local": 0,
                            "region": 0
                        },
                        "period30d": {
                            "local": 0,
                            "region": 0
                        },
                        "total": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "videoGmvConversionRate": 0,
                    "revenuePerThousandPlays": 0,
                    "engageRate": 0,
                    "adAwemeSource": 0,
                    "adAwemeDaysCount": 0,
                    "adAwemeStart": "string",
                    "adAwemeEnd": "string",
                    "adConsumeTotal": 0,
                    "adPlayRate": 0,
                    "adTransactionRate": 0,
                    "adRoas": 0
                },
                "creatorInfo": {
                    "uid": "string",
                    "avatarUrl": "string",
                    "name": "string",
                    "uniqueId": "string",
                    "region": "string",
                    "signature": "string",
                    "followerCountInfo": {
                        "periodCurrent": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "total": 0,
                        "avg": 0
                    },
                    "playCountInfo": {
                        "periodCurrent": 0,
                        "period7d": 0,
                        "period30d": 0,
                        "total": 0
                    },
                    "likeCountInfo": {
                        "total": 0
                    },
                    "shareCountInfo": {
                        "total": 0
                    },
                    "commentCountInfo": {
                        "total": 0
                    },
                    "originCreatorUrl": "string",
                    "videoCountInfo": {
                        "total": 0
                    },
                    "itemVideoCountInfo": {
                        "total": 0
                    },
                    "engageRate": 0,
                    "liveRoomCount": 0,
                    "itemVideoAvgPlayCount": 0,
                    "liveRoomSoldCountPeriod": 0,
                    "categoryList": [
                        {
                            "categoryName": "string",
                            "id": 0,
                            "pid": 0,
                            "region": "string",
                            "level": 0,
                            "tkCategoryId": "string"
                        }
                    ],
                    "itemVideoCountTotal": 0,
                    "videoSoldCount": 0,
                    "videoGmvInfo": {
                        "periodCurrent": {
                            "local": 0,
                            "region": 0
                        },
                        "total": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "currencySymbolInfo": {
                        "local": "string",
                        "region": "string"
                    },
                    "gmvInfo": {
                        "period7d": {
                            "local": 0,
                            "region": 0
                        },
                        "period30d": {
                            "local": 0,
                            "region": 0
                        },
                        "total": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "liveRoomGmvInfo": {
                        "total": {
                            "local": 0,
                            "region": 0
                        }
                    },
                    "videoDuration": {
                        "avg": 0
                    },
                    "soldCountInfo": {
                        "periodCurrent": 0,
                        "total": 0
                    },
                    "mcnName": "string",
                    "userType": 0,
                    "updateTime": 0,
                    "bioEmail": "string",
                    "bioUrl": "string",
                    "insId": "string",
                    "youtubeChannelId": "string",
                    "liveRoomCountInfo": {
                        "total": 0
                    },
                    "discoverTime": "2024-01-15T10:30:00"
                }
            }
        ]
    },
    "serverTime": "2026-02-05 10:53:25"
}