xiyou-openapi
    • 西柚洞察OPENAPI-V2接入指引
    • 西柚洞察OPENAPI接入指引（已归档）
    • Release Notes
    • 西柚洞察OPENAPI-V1接入指引（该接入已归档）
    • asins
      • asin流量得分
        POST
      • asin基础信息变动趋势（天）
        POST
      • asin流量得分趋势（天）
        POST
      • asin广告信息变动趋势（天）
        POST
      • asin BSR排名趋势（天）
        POST
      • asin订单量趋势（月）
        POST
      • asin商品信息趋势图（天）
        POST
      • asin反查关键词列表（最近天）
        POST
      • asin反查关键词列表（月）
        POST
      • asin商品信息
        POST
      • 获取asin变体接口
        POST
    • asinSearchTerms
      • asin词流量趋势（天）
        POST
      • asin词排名趋势（天）
        POST
      • asin词排名趋势（小时）
        POST
    • searchTerms
      • 关键词分析列表（最近天）
        POST
      • 关键词分析列表（月）
        POST
      • 关键词ABA数据趋势（周）
        POST
      • 关键词信息（最近一周）
        POST
    • client
      • 获取client Id的余额
        POST
    • 获取类目树（词或 ASIN）
      POST

      获取类目树（词或 ASIN）

      开发中
      POST
      /v4/marketInsights/category/search

      接口说明#

      根据关键词或 ASIN 搜索亚马逊类目树，返回匹配的类目节点列表。每个类目节点包含：类目 ID、类目名称（站点原文 + 翻译）、所在层级、子类目数量、类目下 ASIN 数量、类目是否可用，以及从根类目到该节点的完整类目路径（可用于展示类目面包屑）。

      使用说明#

      1.
      query 支持两种输入形式：
      关键词：按类目名称进行搜索，返回名称匹配的类目节点；
      ASIN：输入 10 位 ASIN（如 B06XZTZ7GB），返回该商品所属的类目节点。
      2.
      country 为亚马逊站点国家代码（如 US、UK、JP），需与 query 所属站点一致。
      3.
      返回结果 list 中每个节点的 path 数组按层级从根类目到当前类目顺序排列，path 的最后一项即当前类目自身所在位置的上一级链路终点。
      4.
      available = false 表示该类目在当前站点已失效或不可用，业务侧建议过滤或降级展示。
      5.
      childrenCount = 0 表示该类目为叶子类目（无下级类目）。

      请求参数

      Body 参数application/json

      示例
      {
    "country": "US",
    "query": "yoga mat"
}

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location 'https://openapi.xiyouzhaoci.com/v4/marketInsights/category/search' \
--header 'Content-Type: application/json' \
--data '{
    "country": "US",
    "query": "yoga mat"
}'

      返回响应

      🟢200成功
      application/json
      Bodyapplication/json

      示例
      {
    "list": [
        {
            "categoryId": "string",
            "categoryName": {
                "original": "string",
                "translated": "string"
            },
            "level": 0,
            "childrenCount": 0,
            "asinCount": 0,
            "available": true,
            "path": [
                {
                    "categoryId": "string",
                    "categoryName": {
                        "original": "string",
                        "translated": "string"
                    },
                    "available": true
                }
            ]
        }
    ]
}
      修改于 2026-07-10 04:53:30
      上一页
      获取client Id的余额
      Built with