基于关键词和 ASIN 搜索类目

POST

/v1/categories/search

计费规则
本接口无需计费。

用于基于关键词或 ASIN 搜索西柚类目，返回匹配类目的名称、层级、子类目数量、ASIN 数量、匹配得分、可用状态及完整类目路径。

使用说明：
○ country、queryType、query 均为必填字段。
○ queryType=searchTerm 时，query 传关键词，例如 wireless headphones。
○ queryType=asin 时，query 传 ASIN，例如 B0XXXXXXXX。
○ matchScore 表示类目与查询内容的匹配得分，数值越高表示匹配度越高。
○ available=true 表示该类目支持市场洞察查询；false 表示当前不可用于市场洞察。
○ path 从根类目开始，按层级顺序排列至当前类目。
○ 未找到匹配类目时，list 返回空数组。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "country": "US",
  "query": "wireless headphones",
  "queryType": "searchTerm"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.xydc.com/v1/categories/search' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
  "country": "US",
  "query": "wireless headphones",
  "queryType": "searchTerm"
}'

返回响应

🟢200成功

application/json

成功返回匹配的类目列表。

Bodyapplication/json

示例

{
    "list": [
        {
            "categoryId": "us_202605_87_akde91",
            "categoryName": {
                "original": "Headphones",
                "translated": "耳机"
            },
            "level": 3,
            "childrenCount": 12,
            "asinCount": 5000,
            "available": true,
            "path": [
                {
                    "categoryId": "us_202605_87_akde91",
                    "available": true,
                    "categoryName": {
                        "original": "Headphones",
                        "translated": "耳机"
                    }
                }
            ],
            "matchScore": "0.95"
        }
    ]
}

修改于 2026-07-28 09:01:19

获取类目评分数分布

foundation