查询产品关键词分析

POST

/api/v1/products/traffic-keywords/query

按商品ID批量查询热门产品的自然流量词与广告流量词，含关键词中俄文、流量类型、所属类目、周/月搜索指数及环比、商品排名与页内位置、关联商品数、供需比、关联top商品数、有销量产品数、动销率与top10均价。商品ID最多可传10个，多个使用英文逗号分隔；keywordType 默认 ALL；关键词名称支持模糊/精准（默认模糊）；可按周搜索指数、周/月搜索增长率、供需比区间筛选；默认按周搜索指数降序，pageSize 最大 15。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "itemIds": "123456789,987654321",
    "keywordType": "ALL",
    "keyword": "подушка",
    "keywordSearchType": "FUZZY",
    "minWeekSearchIndex": 0,
    "maxWeekSearchIndex": 0,
    "minWeekSearchIndexDynamics": 0,
    "maxWeekSearchIndexDynamics": 0,
    "minMonthSearchIndexDynamics": 0,
    "maxMonthSearchIndexDynamics": 0,
    "minSupplyDemandRatio": 0,
    "maxSupplyDemandRatio": 0,
    "sortField": "WEEK_SEARCH_INDEX",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/products/traffic-keywords/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "itemIds": "123456789,987654321",
    "keywordType": "ALL",
    "keyword": "подушка",
    "keywordSearchType": "FUZZY",
    "minWeekSearchIndex": 0,
    "maxWeekSearchIndex": 0,
    "minWeekSearchIndexDynamics": 0,
    "maxWeekSearchIndexDynamics": 0,
    "minMonthSearchIndexDynamics": 0,
    "maxMonthSearchIndexDynamics": 0,
    "minSupplyDemandRatio": 0,
    "maxSupplyDemandRatio": 0,
    "sortField": "WEEK_SEARCH_INDEX",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "itemId": 0,
            "keywordRu": "string",
            "keywordCn": "string",
            "keywordType": "string",
            "categoryId": 0,
            "categoryPathZh": "string",
            "categoryPathRu": "string",
            "weekSearchIndex": 0,
            "weekSearchIndexDynamics": "50.00%",
            "monthSearchIndex": 0,
            "monthSearchIndexDynamics": "50.00%",
            "rank": 0,
            "rankPosition": "string",
            "productCount": 0,
            "supplyDemandRatio": 123.45,
            "relatedTopProductCount": 0,
            "salesProductCount": 0,
            "salesRate": "50.00%",
            "top10AvgPrice": 123.45
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-09-04 07:45:16

查询产品趋势快照

查询热销产品列表