​
接口说明

Alexa Agent API 将自然语言问题发送给 Amazon Alexa，并返回可供应用、工具或 AI 代理使用的结构化结果。每轮结果包含 AI 生成的文本回答，并在可用时提供相关商品推荐和后续问题建议。

该 API 适用于 AI 购物助手、商品发现、产品研究、市场分析及自动化购物工作流等场景。

支持美国与日本市场的独立账号池，默认使用美国市场。普通问答可通过原生 HTTP 通道返回正文、商品推荐和追问，截图使用页面通道。同次调用内可连续对话，不同调用不保留对话上下文。站点能力以实际开通为准，商品和追问是否返回取决于 Amazon 的回答。

​
申请开通

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

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

​
返回字段

字段类型说明
codeint状态码，0 表示成功
messagestring状态说明
dataobject返回数据

​
data 字段

字段类型说明
jsonarray对话结果列表，每个元素对应一轮 Alexa 回答
taskIdstring任务唯一标识
urlstring结果关联页面地址
screenshotstring可选的页面截图地址；未生成截图时可能为空

​
单轮对话字段

字段类型说明
promptstring本轮对话的问题
contentstringAlexa 生成的文本回答
productsarray相关商品分组，每组包含 title 和 items
follow_up_questionsstring[]Alexa 建议的后续问题
screenshotstring本轮对话的可选截图地址

​
商品字段

字段类型说明
asinstringAmazon 商品 ASIN
urlstring商品详情页地址
titlestring商品标题
coverstring商品封面图地址
scorestring商品评分
ratingsCountstring评分数量
pricestring当前价格，包含币种符号
originalPricestring原价或划线价；没有时为空
describestring商品简介或推荐说明

​
返回示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "example-task-id",
    "url": "",
    "json": [
      {
        "prompt": "books for a long flight",
        "content": "Here are several popular books you may enjoy on a long flight.",
        "products": [
          {
            "title": "Recommended books",
            "items": [
              {
                "asin": "B08BKGYQXW",
                "url": "https://www.amazon.com/dp/B08BKGYQXW",
                "title": "Example book title",
                "cover": "https://m.media-amazon.com/images/example.jpg",
                "score": "4.7",
                "ratingsCount": "75,007",
                "price": "$4.99",
                "originalPrice": "",
                "describe": "A popular choice for travel reading."
              }
            ]
          }
        ],
        "follow_up_questions": [
          "Does it have an audiobook version?",
          "Compare with similar books"
        ],
        "screenshot": ""
      }
    ],
    "screenshot": ""
  }
}

​
积点说明

  • 每轮 Alexa 对话消耗 6 积点。
  • 一次任务包含多轮对话时，按实际对话轮数累计计费。