1. 资源生成
xiyou-openapi
  • 西柚洞察OPENAPI-V2接入指引
  • 西柚洞察OPENAPI接入指引(已归档)
  • Release Notes
  • 西柚洞察OPENAPI-V1接入指引(该接入已归档)
  • asins
    • asin流量得分
      POST
    • asin基础信息变动趋势(天)
      POST
    • asin流量得分趋势(天)
      POST
    • asin流量得分趋势(周)
      POST
    • asin流量得分趋势(月)
      POST
    • asin广告信息变动趋势(天)
      POST
    • asin BSR排名趋势(天)
      POST
    • asin订单量趋势(月)
      POST
    • asin商品信息趋势图(天)
      POST
    • asin反查关键词列表(最近天)
      POST
    • asin反查关键词列表(月)
      POST
    • asin商品信息
      POST
    • asin近30天订单量
      POST
    • 获取asin变体接口
      POST
  • asinSearchTerms
    • asin词流量趋势(天)
      POST
    • asin词排名趋势(天)
      POST
    • asin词排名趋势(小时)
      POST
  • searchTerms
    • 关键词ABA数据趋势(周)
      POST
    • 关键词信息(最近一周)
      POST
    • 关键词分析列表(最近天)
      POST
    • 关键词分析列表(月)
      POST
  • client
    • 获取client Id的余额
      POST
  • 市场洞察
    • 资源生成
      • 生成类目洞察资源
        POST
      • 查询市场资源状态
        POST
    • 市场榜单
      • 获取类目月度销量榜
        POST
      • 获取类目年度销量榜
        POST
      • 获取类目月度新秀榜
        POST
      • 获取类目年度新秀榜
        POST
      • 获取类目月度飙升榜
        POST
      • 获取类目年度飙升榜
        POST
    • 关键词洞察
      • 获取类目关键词分析
        POST
      • 获取类目关键词搜索量趋势
        POST
      • 获取类目关键词列表
        POST
    • 类目销售走势
      • 获取类目市场规模趋势
        POST
      • 获取类目季节性分析
        POST
    • 新品机会分析
      • 类目新老品销量及数量趋势
        POST
    • 价格段机会分析
      • 获取各价格段市场销量趋势
        POST
    • 竞争格局总览
      • 获取价格段 ASIN 列表
        POST
      • 获取类目各品牌市场规模
        POST
      • 批量获取品牌销量趋势
        POST
      • 获取价格段父 ASIN 列表
        POST
    • 评分分析
      • 获取类目评分分布
        POST
      • 获取类目评分数分布
        POST
    • 基于关键词和 ASIN 搜索类目
      POST
  • foundation
    • 获取市场洞察的可用日期
      GET
  1. 资源生成

查询市场资源状态

POST
/v1/marketInsights/category/resource/status
计费规则
本接口不计费。查询类目洞察资源的生成状态不消耗 Credits。
○ 公式:Credit 消耗 = 0
○ 示例:使用 resourceId 查询资源生成状态,不消耗 Credits。
用于查询类目洞察资源的异步生成状态。传入“生成类目洞察资源”接口返回的 resourceId 进行轮询查询。
状态说明:
○ pending:任务已创建,等待处理。
○ processing:资源正在生成。
○ success:资源生成完成,可使用该 resourceId 请求后续类目洞察数据。
○ failed:资源生成失败,请重新发起生成任务。

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "resourceId": "3cdd069d0jj1f754",
  "categoryId": "us_202605_87_akde91",
  "country": "US"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.xydc.com/v1/marketInsights/category/resource/status' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
  "resourceId": "3cdd069d0jj1f754",
  "categoryId": "us_202605_87_akde91",
  "country": "US"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "status": "pending"
}
修改于 2026-07-28 09:27:19
上一页
生成类目洞察资源
下一页
市场榜单
Built with