​
About the API

The Alexa Agent API sends natural-language questions to Amazon Alexa and returns structured results for applications, tools, and AI agents. Each conversation turn includes an AI-generated text answer and, when available, related product recommendations and suggested follow-up questions.

The API is suitable for AI shopping assistants, product discovery, product research, market analysis, and automated shopping workflows.

Independent account pools support the United States and Japan, with the United States as the default market. Ordinary questions use a native HTTP path for answers, product recommendations and follow-up suggestions; screenshots use the browser path. Turns within a call can share context; separate calls do not. Availability depends on enabled markets, and recommendations depend on Amazon’s answer.

​
Apply for access

To ensure service reliability, this API is currently available on a limited-access basis. Access is granted according to your use case and expected usage volume.

Integration details, request parameters, and credentials are provided only after approval. Public documentation does not expose invocation code or offer Playground testing.

​
Response fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success
messagestringStatus message
dataobjectResponse payload

​
data fields

FieldTypeDescription
jsonarrayConversation results; each item represents one Alexa response
taskIdstringUnique task identifier
urlstringPage URL associated with the result
screenshotstringOptional page screenshot URL; may be empty when no screenshot is generated

​
Conversation result fields

FieldTypeDescription
promptstringQuestion for this conversation turn
contentstringAlexa-generated text answer
productsarrayRelated product groups; each group contains title and items
follow_up_questionsstring[]Follow-up questions suggested by Alexa
screenshotstringOptional screenshot URL for this turn

​
Product fields

FieldTypeDescription
asinstringAmazon product ASIN
urlstringProduct detail page URL
titlestringProduct title
coverstringProduct image URL
scorestringProduct rating
ratingsCountstringNumber of ratings
pricestringCurrent price, including currency symbol
originalPricestringOriginal or struck-through price; empty when unavailable
describestringProduct summary or recommendation note

​
Response example

{
  "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": ""
  }
}

​
Credit usage

  • Each Alexa conversation turn costs 6 credits.
  • When a task contains multiple conversation turns, credits are charged for the actual number of turns.