Item Search V2

GET

/api/item/v2/search

Search for items with period-based sales data. Supports filtering by period (1d/7d/30d/90d/180d/365d), and returns core metrics including period GMV, growth rate, sold count, and creator conversion rate.

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/v2/search?period=7d&itemName=&region=US&tkCategoryLv1Id=&tkCategoryLv2Id=&tkCategoryLv3Id=&localPriceBegin=&localPriceEnd=&soldCountTotalBegin=&soldCountTotalEnd=&discoverTimeStartDs=20251201&discoverTimeEndDs=20251231&fullManagedFlag=&sellerTypes=&commissionRateBegin=&commissionRateEnd=&sortField=periodSoldCount&sortType=desc&gmvBegin=&gmvEnd=&gmvGrowthRateBegin=&gmvGrowthRateEnd=&soldCountBegin=&soldCountEnd=&creatorTotalBegin=&creatorTotalEnd=&creatorSoldCountRateBegin=&creatorSoldCountRateEnd=&primarySaleMode=&primarySaleChannel=&pageNo=1&pageSize=10' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: ja-JP'

Responses

🟢200Success

json

Body

Example

{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "itemId": "string",
                "itemName": "string",
                "region": "string",
                "categoryId": "string",
                "categoryName": "string",
                "tkCategoryLv1Id": "string",
                "tkCategoryLv1Name": "string",
                "tkCategoryLv2Id": "string",
                "tkCategoryLv2Name": "string",
                "tkCategoryLv3Id": "string",
                "tkCategoryLv3Name": "string",
                "itemPicUrl": "string",
                "priceList": [
                    {
                        "local": 0,
                        "region": 0
                    }
                ],
                "currencySymbolInfo": {
                    "local": "string",
                    "region": "string"
                },
                "period": "string",
                "periodGmv": {
                    "local": 0,
                    "region": 0
                },
                "periodGmvGrowthRate": 0,
                "periodSoldCount": 0,
                "periodSoldGrowthRate": 0,
                "periodAvgPrice": {
                    "local": 0,
                    "region": 0
                },
                "periodCreatorSoldCountRate": 0,
                "top3VideoList": [
                    {
                        "video_id": "string",
                        "video_title": "string",
                        "discover_time": "string",
                        "create_time": "string",
                        "update_time": "string",
                        "duration": 0,
                        "video_sold_count": 0,
                        "rn": 0
                    }
                ],
                "gmvTotal": {
                    "local": 0,
                    "region": 0
                },
                "soldCountTotal": 0,
                "commissionRate": 0,
                "fullManagedFlag": 0,
                "sellerId": "string",
                "sellerName": "string",
                "shopLogoUrl": "string",
                "sellerSoldCountTotal": 0,
                "sellerGmvTotal": {
                    "local": 0,
                    "region": 0
                },
                "sellerType": "string",
                "discoverTime": "string",
                "relatedVideoCount": 0,
                "relatedCreatorCount": 0,
                "valid": 0
            }
        ]
    },
    "serverTime": "2026-02-05 10:53:25"
}

Modified at 2026-03-18 02:55:38

Item Search

Item Basic