Alexa Listing API
Retrieve Alexa preset questions from an Amazon product detail page by ASIN and optionally generate answers grounded in that product, revealing how Alexa interprets its product information and customer feedback.
About the API
The Alexa Listing API uses an ASIN to retrieve the Alexa preset questions available on an Amazon product detail page. Questions fall into two categories:
- Product questions: Questions about the product itself, including features, specifications, usage, and other product information.
- Review questions: Questions generated from or associated with customer reviews and consumer feedback.
The response includes the product and review questions discovered on the page. Retrieve questions only or generate ASIN-grounded answers for either category or both. This API currently supports Amazon US (amazon.com) only.
It is designed for product research, listing analysis, consumer insights, competitive intelligence, and AI-agent workflows that need to understand how Alexa presents a specific product.
Request URL
Request headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Replace <YOUR_API_KEY> with your API key and authenticate with Authorization: Bearer <YOUR_API_KEY>.
Request parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
asin | string | Conditional | — | 10-character ASIN; provide at least one of asin or url |
url | string | Conditional | — | amazon.com product detail URL; if supplied with asin, both must identify the same product |
includeAnswers | boolean | No | false | Generate answers for the questions |
region | string | No | all | Answer selection: region1 product questions, region2 review questions, or all; this does not filter question discovery |
concurrency | integer | No | 5 | Concurrent answer generation, from 1 to 10 |
Request examples
Retrieve questions without generating answers:
Generate answers for all regions
Answer product questions only
Use the same API key as for other APIs. Questions and answers are returned synchronously; allow at least 120 seconds when requesting answers. region selects which questions receive answers, not which questions are discovered. Keep includeAnswers: false when answers are not needed.
Playground
Open the Alexa Listing API Playground
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | Status code; 0 indicates success |
message | string | Status message |
pointCost | number | Credits actually charged for this request |
data | object | Response payload |
data fields
| Field | Type | Description |
|---|---|---|
asin | string | Normalized product ASIN |
regions.region1 | array | Questions found in the first product-detail-page region |
regions.region2 | array | Questions found in the second product-detail-page region |
regions.panel | array | Optional initial suggestions from the product side panel when both inline regions are empty; these are distinct from answer follow-ups |
Each question object contains:
| Field | Type | Description |
|---|---|---|
question | string | Alexa preset question |
answer | string | null | Alexa text answer bound to the current ASIN; null when not requested or unavailable |
source | string | panel for side-panel fallback suggestions; optional for inline regions |
Both inline regions are always returned. When neither contains questions, the service checks the product side panel for initial suggestions. If Amazon provides none, the result is empty; questions are never invented. Panel answers are generated when all answer regions are selected and count as one region for billing. When only one inline region is selected, panel answers remain null.
Response example
Credit usage
Credits are settled from the result actually obtained. Answers are billed by question category, not by the number of individual questions.
| Actual result | Credits |
|---|---|
| The page is valid but exposes no Alexa questions, or collection fails because of a service error | 0 |
| Alexa questions are returned, with no valid answer in either category | 5 |
| Questions are returned and either product or review questions receive a valid answer | 25 |
| Questions are returned and both product and review questions receive valid answers | 45 |
An explicitly invalid ASIN is charged once for question discovery and costs 5 credits. The response field pointCost reports the credits actually charged.

