Video - Search V2

GET

/api/item_video/v2/search

Video Search V2, based on video_search_v9 index, supports period-based filtering and sorting

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://open.tabcut.com:8090/api/item_video/v2/search?searchText=&region=US&period=30d&itemVideoFlag=&creatorCategoryId=&tkCategoryLv1Ids=&tkCategoryLv2Ids=&tkCategoryLv3Ids=&videoCreateTimeBegin=20260101&videoCreateTimeEnd=20260401&videoLocalGmvBegin=&videoLocalGmvEnd=&videoLocalGmvGrowthRateBegin=&videoLocalGmvGrowthRateEnd=&avgPriceBegin=&avgPriceEnd=&videoSoldCountBegin=&videoSoldCountEnd=&adDaysBegin=&adDaysEnd=&adPlayRateBegin=&adPlayRateEnd=&adConsumeBegin=&adConsumeEnd=&adRoasBegin=&adRoasEnd=&durationBegin=&durationEnd=&videoPlayCountBegin=&videoPlayCountEnd=&creatorFollowerCountTotalBegin=&creatorFollowerCountTotalEnd=&videoEngageRateBegin=&videoEngageRateEnd=&viewerPrimaryGender=&viewerPrimaryAge=&viewerPrimaryCountry=&sortField=videoSoldCountPeriod&sortType=desc&pageNo=1&pageSize=10' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "videoId": "string",
                "region": "string",
                "videoCoverUrl": "string",
                "videoPlayUrl": "string",
                "tkVideoUrl": "string",
                "videoDesc": "string",
                "videoDuration": 0,
                "itemId": "string",
                "itemName": "string",
                "itemCoverUrl": "string",
                "itemSoldCountTotal": 0,
                "priceAmount": {
                    "local": 0,
                    "region": 0
                },
                "currencySymbolInfo": {
                    "local": "string",
                    "region": "string"
                },
                "videoPlayCountPeriod": 0,
                "videoEngageRatePeriod": 0,
                "videoSoldCountPeriod": 0,
                "videoLocalGmvPeriod": {
                    "local": 0,
                    "region": 0
                },
                "createTime": "string",
                "revenuePerThousandPlaysPeriod": 0,
                "actionCostPeriod": 0,
                "adPlayRatePeriod": 0,
                "adTransactionRatePeriod": 0,
                "adConsumePeriod": 0,
                "adRoasPeriod": 0,
                "videoConversionRatePeriod": 0,
                "adDaysPeriod": 0,
                "authorUid": "string",
                "authorAvatarUrl": "string",
                "authorNickName": "string",
                "authorUniqueId": "string",
                "authorFollowerCountTotal": 0,
                "adAwemeSource": 0
            }
        ]
    },
    "serverTime": "2026-04-03 10:00:00"
}

Modified at 2026-04-07 08:06:33

Video Search

Item Video Basic