1. foundation
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. foundation

获取市场洞察的可用日期

GET
/v1/foundation/marketInsights/availableDates
计费规则
本接口不计费。查询市场洞察相关资源的可用日期不消耗 Credits。
○ 公式:Credit 消耗 = 0
○ 示例:查询市场洞察的可用日期,不消耗 Credits。
用于获取指定国家的市场洞察可用日期。
使用说明:
○ country 为必填 Query 参数。
○ resource 仅支持 MarketInsightsAsinInfo 和 SearchTermsInfo。
○ 响应通过 entities 按资源返回 cycleDates 和 periodDates。
○ periodDates 中 period = "last30days" 对应的 date 为近30天数据的最新可用日期。

请求参数

Query 参数

Header 参数

请求示例代码

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/foundation/marketInsights/availableDates?country=undefined' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "entities": [
        {
            "resource": "MarketInsightsAsinInfo",
            "cycleDates": [
                {
                    "cycle": "daily",
                    "startCycle": {
                        "startDate": "string",
                        "endDate": "string"
                    },
                    "endCycle": {
                        "startDate": "string",
                        "endDate": "string"
                    }
                }
            ],
            "periodDates": [
                {
                    "period": "last30days",
                    "date": "string"
                }
            ]
        }
    ]
}
修改于 2026-07-28 09:15:06
上一页
foundation
Built with