商品域-商品搜索 v2

正式环境

http://open.tabcut.com:8090

GET

/api/item/v2/search

查询周期内商品销售数据，支持按周期（1d/7d/30d/90d/180d/365d）筛选，包含周期内销售额、增长率、销量、达人出单率等核心指标

请求参数

Query 参数

Header 参数

请求示例代码

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: au3iGmLAuPj' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: ja-JP'

返回响应

🟢200成功

json

Body

示例

{
    "code": "200",
    "message": "成功!",
    "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"
}

修改于 2026-03-18 02:07:05

商品搜索

商品详情页基础信息