Category - Potential Categories

GET

/api/category/potential

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/category/potential?region=US&yearMonth=202501&tkCategoryLv1Ids=601586&tkCategoryLv2Ids=&tkCategoryLv3Ids=&categoryLevels=L1&perDayGmvIncrRateStart=0.1&perDayGmvIncrRateEnd=0.5&top3SellerGmvRatioStart=&top3SellerGmvRatioEnd=&top10SellerGmvRatioStart=&top10SellerGmvRatioEnd=&localGmvStart=&localGmvEnd=&avgSellerLocalGmvStart=&avgSellerLocalGmvEnd=&sortField=gmvPeriod&sortType=desc&pageNo=1&pageSize=10' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: en'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "tkLvId": "string",
                "tkLvName": "string",
                "level": "string",
                "gmvInfo": {
                    "periodCurrent": {
                        "local": 0,
                        "region": 0
                    },
                    "period1d": {
                        "local": 0,
                        "region": 0
                    }
                },
                "perDayGmvIncrRate": 0,
                "sellerCount": 0,
                "soldItemCount": 0,
                "soldCountMonth": 0,
                "avgSellerGmv": {
                    "local": 0,
                    "region": 0
                },
                "avgPrice": {
                    "local": 0,
                    "region": 0
                },
                "avgCommissionRate": 0,
                "top3SellerGmvRatio": 0,
                "top10SellerGmvRatio": 0,
                "videoLocalGmvRatio": 0,
                "liveLocalGmvRatio": 0,
                "othersLocalGmvRatio": 0,
                "creatorLocalGmvRatio": 0,
                "gmvTrendList": [
                    {
                        "date": "20250101",
                        "local": 0,
                        "region": 0
                    }
                ],
                "top3ItemList": [
                    {
                        "itemId": "string",
                        "itemName": "string",
                        "itemCoverUrl": "string",
                        "sellerId": "string",
                        "localGmv": "string",
                        "localSkuMinPrice": "string",
                        "rn": 0
                    }
                ]
            }
        ]
    },
    "serverTime": "2026-02-05 10:53:25"
}

Modified at 2026-04-13 08:32:38

Item Video Item List V3

Category - Market GMV Trend