- 【Must-Read】About Signature
- Data APIs
- Item
- Product - RankingGET
- Product - Search V1GET
- Product - Search V2GET
- Product - Basic InfoGET
- Product - SKU InfoGET
- Product - Video List V1GET
- Product - Video List V2GET
- Product - Video List V3GET
- Product - Video Statistics V2GET
- Product - Creator List V1GET
- Product - Creator List V2GET
- Product - Creator List V3GET
- Product - TrendGET
- Product - Sales Mode Distribution V1GET
- Product - Sales Mode Distribution V2GET
- Item Sales Channels DistributionGET
- Product - Sales Channel Distribution V2GET
- Product - Live List V1GET
- Product - Live List V2GET
- Product - Live List V3GET
- Product - Live Statistics V1GET
- Item Live Statistics V2GET
- Product - Creator Statistics V1GET
- Product - Creator Statistics V2GET
- Product - Ranking
- 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
- Category
- Hashtag
- Live
- Data Expand
- Meta APIs
- Data
- Schemas
Product - Video List V3
GET
/api/item/v3/video_list
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/v3/video_list?itemId=&sortField=createTime&sortType=desc&pageNo=1&pageSize=10&videoCreateStartDs=20241122&videoCreateEndDs=20251221&videoWithSoldFlag=&videoWithAdsFlag=' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: ja-JP'Responses
🟢200Success
json
Bodyjson
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,
"videoConversionRate": 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"
}🟢200Parameter Error
🟢200Signature Error
🟢200Server Error
Modified at 2026-10-23 09:02:11