申请开通

为保障服务的稳定性和可靠性,该 API 目前采用定向开放方式。我们将根据您的使用场景和预期调用量开通权限。

调用方式、请求参数和接入凭证仅向审核通过的客户提供,公开文档不展示调用代码,也不提供 Playground 在线调试。

接口说明

Alexa Listing API 以 ASIN 为对象,返回 Amazon 商品详情页中可用的 Alexa 预设问题。问题分为两类:

  • 产品问题:围绕商品本身提出的问题,例如产品功能、规格、使用方式及其他产品相关信息。
  • 评论问题:基于消费者评论和用户反馈生成或关联的问题。

服务始终返回产品问题和评论问题。获得权限后,您可以仅获取问题,也可以为其中一类或两类问题生成与当前 ASIN 关联的 AI 回答。

适用于商品研究、Listing 分析、消费者洞察、竞品分析,以及需要理解 Alexa 如何呈现具体商品的 AI 代理工作流。

返回字段

字段类型说明
codeint状态码,0 表示成功
messagestring状态说明
pointCostnumber本次实际消耗的积点数
dataobject返回数据

data 字段

字段类型说明
asinstring标准化后的商品 ASIN
regions.region1array商品详情页第一区域的问题列表
regions.region2array商品详情页第二区域的问题列表

每个区域中的问题对象包含:

字段类型说明
questionstringAlexa 预设问题
answerstring | null与当前 ASIN 绑定的 Alexa 文本答案;未获取或获取失败时为 null

无论是否获取答案,两个区域的问题都会完整返回。仅获取其中一个区域的答案时,另一区域仍返回问题,其 answernull

返回示例

{
  "code": 0,
  "message": "ok",
  "pointCost": 25,
  "data": {
    "asin": "B0GKZTC7FZ",
    "regions": {
      "region1": [
        {
          "question": "Is this product suitable for sensitive skin?",
          "answer": "The product information describes materials intended for comfortable everyday use, but individual sensitivities can vary."
        }
      ],
      "region2": [
        {
          "question": "What do customers say about the size?",
          "answer": null
        }
      ]
    }
  }
}

积点说明

积点按实际获得的结果结算。答案按问题类别计费,不按单个问题数量重复累计。

实际结果消耗积点
页面有效,但没有可用的 Alexa 问题;或服务端采集失败0
返回 Alexa 问题,未获得任何类别的有效答案5
返回 Alexa 问题,且产品问题或评论问题中有一类获得有效答案25
返回 Alexa 问题,且产品问题和评论问题两类均获得有效答案45

明确无效的 ASIN 按一次问题发现计费,消耗 5 积点。响应中的 pointCost 是本次实际扣除的积点数。