POST
https://api.nexscope.ai/api/skill-api/v1/skills/amazon-alexa-search/runRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/api/skill-api/v1/skills/amazon-alexa-search/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
prompts | array | required | Conversation prompt array, supports only 1 entry. Each call accepts only 1 question. For follow-up questions, the agent must summarize key information from the previous response (recommended products, ASINs, key conclusions, etc.), concatenate it with the new question, and send it as a new prompts[0]. Each call is an independent new session and does not retain cross-call conversation history Example: [
"What are good phone cases for iPhone?"
] |
format | string | optional | Response format: markdown (default) returns a readable report; json returns a structured data array |
url | string | optional | Linked page URL, used to supplement the page context of Alexa's current response. Only pass this when the user provides a specific page (category page / search results page / product detail page, etc.); do not pass this parameter for the Amazon homepage (e.g. https://www.amazon.com/) Example: https://example.com/image.jpg |
Request example
{
"format": "markdown",
"prompts": [
"What are good phone cases for iPhone?"
]
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.products[].stdout | string | optional | Markdown format Q&A report, containing each round's user question, Alexa answer, recommended products, and follow-up questions; only returned when format=markdown Example: null |
data.data | array | optional | Structured conversation result array; only returned when format=json Example: [] |
data.resultsNum | integer | optional | Number of conversation rounds Alexa actually answered; 0 means no valid response was produced Example: 1 |
data.products[].msg/errmsg | string | optional | Response message, ok on success Example: null |
data.costTime | integer | optional | API latency in milliseconds Example: 1 |
data.costToken | integer | optional | Tokens consumed by this call; charged only if upstream succeeds Example: 1 |
data.taskId | string | optional | Task identifier returned by upstream Example: example-id |
data.type | string | optional | Render style: stdoutWorkbenches (markdown) or json Example: null |
data.data[].prompt | string | optional | Prompt sent to Alexa for this round Example: null |
data.data[].content | string | optional | Text content of Alexa's response for this round Example: null |
data.data[].screenshot | string | optional | Screenshot link for this round's conversation Example: null |
data.data[].followUpQuestions | array | optional | List of follow-up questions recommended by Alexa Example: [] |
data.data[].products | array | optional | Recommended product group list, each group containing title and items Example: [] |
data.products[].title | string | optional | Recommended group title Example: null |
data.products[].items[].asin | string | optional | Product ASIN Example: B072MQ5BRX |
data.products[].items[].title | string | optional | Product title Example: null |
data.products[].items[].url | string | optional | Product detail page URL Example: https://example.com/image.jpg |
data.products[].items[].cover | string | optional | Product cover image URL Example: null |
data.products[].items[].price | string | optional | Current price (with currency) Example: null |
data.products[].items[].originalPrice | string | optional | Original or strikethrough price Example: null |
data.products[].items[].score | string | optional | Rating Example: null |
data.products[].items[].ratingsCount | string | optional | Review count Example: null |
data.products[].items[].describe | string | optional | Product description Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"data": {
"data": [
{
"followUpQuestions": [],
"products": []
}
],
"resultsNum": 1,
"costTime": 1,
"costToken": 1,
"taskId": "example-id",
"products": [
{
"items": [
{
"asin": "B072MQ5BRX",
"url": "https://example.com/image.jpg"
}
]
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 400 | Request JSON or required API parameters are invalid. |
| 401 | API key is missing, invalid, or cannot be matched to a user. |
| 5xx | API execution or upstream service failed. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.