Item Search

GET

/api/item/search

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/search?itemName=&region=&categoryLv1Id=&categoryLv2Id=&categoryLv3Id=&localPriceBegin=&localPriceEnd=&soldCountTotalBegin=&soldCountTotalEnd=&discoverTimeBegin=&discoverTimeEnd=&fullManagedFlag=&sortField=&sortOrder=&sellerTypes&commissionRateBegin=0.5&commissionRateEnd=0.7&pageNo=&pageSize=' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: zh-CN'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "200",
    "message": "成功!",
    "result": {
        "total": 262,
        "pageNo": 1,
        "pageSize": 3,
        "data": [
            {
                "itemId": "1731371166448715537",
                "itemName": "Boné Aba Curva Premium Strapback Dad Hat Escolha sua Cor",
                "region": "BR",
                "categoryId": "605248",
                "categoryName": "时尚配件",
                "categoryLv1Id": "605248",
                "categoryLv1Name": "时尚配件",
                "categoryLv2Id": "905224",
                "categoryLv2Name": "服饰配件",
                "categoryLv3Id": "906248",
                "categoryLv3Name": "帽子",
                "priceOrigin": 29.7,
                "soldCount1d": 0,
                "soldGrowthRate1d": -1.0000,
                "soldCount7d": 2,
                "soldGrowthRate7d": -0.6667,
                "soldCount30d": 23,
                "soldGrowthRate30d": -0.3784,
                "ds": "20251222",
                "itemPicUrl": "https://cdn.tabcut.com/dataservice/media/item/1731371166448715537/17313711664487155370.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "regionComment": "巴西",
                "localPriceCurrency": "BRL",
                "localCurrencySymbol": "R$",
                "soldCountTotal": 265,
                "discoverTime": "2025-07-13 03:32:51",
                "currencySymbolInfo": {
                    "local": "R$",
                    "region": "$"
                },
                "gmvInfo": {
                    "period1d": {
                        "local": 0.00,
                        "region": 0.00
                    },
                    "period7d": {
                        "local": 59.40,
                        "region": 10.94
                    },
                    "period30d": {
                        "local": 701.25,
                        "region": 129.10
                    },
                    "total": {
                        "local": 7845.75,
                        "region": 1444.41
                    }
                },
                "priceList": [
                    {
                        "local": 29.70,
                        "region": 5.47
                    }
                ],
                "commissionRate": 0.5000,
                "fullManagedFlag": 0,
                "sellerName": "Congratulations Store",
                "shopLogoUrl": "https://cdn.tabcut.com/dataservice/media/seller/7496181809856809745/avatar.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "sellerSoldCountInfo": {
                    "total": 24767
                },
                "itemSoldCountInfo": {
                    "period1d": 0,
                    "period7d": 2,
                    "period30d": 23,
                    "total": 265
                },
                "relatedVideoCount": 24,
                "relatedCreatorCount": 15,
                "sellerId": "7496181809856809745",
                "sellerType": "local",
                "valid": 1
            },
            {
                "itemId": "1732560623170586615",
                "itemName": "Bálsamo Je's Premium Natural Colmavit 2 Original - 24 Cápsulas Cada- Preto",
                "region": "BR",
                "categoryId": "700645",
                "categoryName": "保健",
                "categoryLv1Id": "700645",
                "categoryLv1Name": "保健",
                "categoryLv2Id": "700646",
                "categoryLv2Name": "保健食品",
                "categoryLv3Id": "700650",
                "categoryLv3Name": "保健食品",
                "priceOrigin": 39.0,
                "soldCount1d": 0,
                "soldGrowthRate1d": -1.0000,
                "soldCount7d": 1,
                "soldGrowthRate7d": 1.0000,
                "soldCount30d": 1,
                "soldGrowthRate30d": 0.0000,
                "ds": "20251222",
                "itemPicUrl": "https://cdn.tabcut.com/dataservice/media/item/1732560623170586615/17325606231705866150.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "regionComment": "巴西",
                "localPriceCurrency": "BRL",
                "localCurrencySymbol": "R$",
                "soldCountTotal": 7,
                "discoverTime": "2025-11-07 14:52:06",
                "currencySymbolInfo": {
                    "local": "R$",
                    "region": "$"
                },
                "gmvInfo": {
                    "period1d": {
                        "local": 0.00,
                        "region": 0.00
                    },
                    "period7d": {
                        "local": 39.00,
                        "region": 7.18
                    },
                    "period30d": {
                        "local": 39.00,
                        "region": 7.18
                    },
                    "total": {
                        "local": 21099.00,
                        "region": 3884.35
                    }
                },
                "priceList": [
                    {
                        "local": 39.00,
                        "region": 7.18
                    }
                ],
                "commissionRate": 0.5000,
                "fullManagedFlag": 0,
                "sellerName": "LEALPHARMA",
                "shopLogoUrl": "https://cdn.tabcut.com/dataservice/media/seller/7496186619090406391/avatar.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "sellerSoldCountInfo": {
                    "total": 927
                },
                "itemSoldCountInfo": {
                    "period1d": 0,
                    "period7d": 1,
                    "period30d": 1,
                    "total": 7
                },
                "relatedVideoCount": 2,
                "relatedCreatorCount": 1,
                "sellerId": "7496186619090406391",
                "sellerType": "local",
                "valid": 1
            },
            {
                "itemId": "1731369994993436433",
                "itemName": "Boné de Beisebol Feminino com Letras Adequado para Esportes ao ar livre ou Viagens",
                "region": "BR",
                "categoryId": "603014",
                "categoryName": "运动与户外",
                "categoryLv1Id": "603014",
                "categoryLv1Name": "运动与户外",
                "categoryLv2Id": "834824",
                "categoryLv2Name": "运动与户外配件",
                "categoryLv3Id": "603654",
                "categoryLv3Name": "运动与户外帽",
                "priceOrigin": 30.0,
                "soldCount1d": 0,
                "soldGrowthRate1d": 0.0000,
                "soldCount7d": 0,
                "soldGrowthRate7d": 0.0000,
                "soldCount30d": 0,
                "soldGrowthRate30d": 0.0000,
                "ds": "20250619",
                "itemPicUrl": "https://cdn.tabcut.com/dataservice/media/item/1731369994993436433/17313699949934364330.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "regionComment": "巴西",
                "localPriceCurrency": "BRL",
                "localCurrencySymbol": "R$",
                "soldCountTotal": 0,
                "discoverTime": "2025-05-26 12:19:24",
                "currencySymbolInfo": {
                    "local": "R$",
                    "region": "$"
                },
                "gmvInfo": {
                    "period1d": {
                        "local": 0.00,
                        "region": 0.00
                    },
                    "period7d": {
                        "local": 0.00,
                        "region": 0.00
                    },
                    "period30d": {
                        "local": 0.00,
                        "region": 0.00
                    },
                    "total": {
                        "local": 0.00,
                        "region": 0.00
                    }
                },
                "priceList": [
                    {
                        "local": 30.00,
                        "region": 5.52
                    }
                ],
                "commissionRate": 0.6000,
                "fullManagedFlag": 0,
                "sellerName": "Congratulations Store",
                "shopLogoUrl": "https://cdn.tabcut.com/dataservice/media/seller/7496181809856809745/avatar.webp?x-oss-process=image/resize,w_246,h_246/format,webp",
                "sellerSoldCountInfo": {
                    "total": 45
                },
                "itemSoldCountInfo": {
                    "period1d": 0,
                    "period7d": 0,
                    "period30d": 0,
                    "total": 0
                },
                "relatedVideoCount": 0,
                "relatedCreatorCount": 0,
                "sellerId": "7496181809856809745",
                "sellerType": "local",
                "valid": 1
            }
        ],
        "translated": ""
    },
    "serverTime": "2025-12-23 17:22:07"
}

Modified at 2025-12-25 10:47:52

Item Ranking

Item Basic