POST
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-alexa-search/runRun this API
Send a JSON request to execute this API and receive the direct response payload.
Endpoint
| Method | POST |
| Path | https://claw-callback.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
{
"prompts": [
"What are good phone cases for iPhone?"
],
"format": "markdown"
}Response body
Returns the documented upstream API response directly without an additional wrapper.
| Name | Type | Required | Description |
|---|---|---|---|
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 |
data | array | optional | Structured conversation result array; only returned when format=json Example: [] |
resultsNum | integer | optional | Number of conversation rounds Alexa actually answered; 0 means no valid response was produced Example: 1 |
code | string | optional | Business status code, "200" on success (same as numeric errcode) |
errcode | integer | optional | Business status code (HTTP layer is generally 200; use this field to determine business success/failure) Example: 1 |
products[].msg/errmsg | string | optional | Response message, ok on success |
costTime | integer | optional | API latency in milliseconds Example: 1 |
costToken | integer | optional | Tokens consumed by this call; charged only if upstream succeeds Example: 1 |
taskId | string | optional | Task identifier returned by upstream Example: example-id |
type | string | optional | Render style: stdoutWorkbenches (markdown) or json |
data[].prompt | string | optional | Prompt sent to Alexa for this round |
data[].content | string | optional | Text content of Alexa's response for this round |
data[].screenshot | string | optional | Screenshot link for this round's conversation |
data[].followUpQuestions | array | optional | List of follow-up questions recommended by Alexa Example: [] |
data[].products | array | optional | Recommended product group list, each group containing title and items Example: [] |
products[].title | string | optional | Recommended group title |
products[].items[].asin | string | optional | Product ASIN Example: B072MQ5BRX |
products[].items[].title | string | optional | Product title |
products[].items[].url | string | optional | Product detail page URL Example: https://example.com/image.jpg |
products[].items[].cover | string | optional | Product cover image URL |
products[].items[].price | string | optional | Current price (with currency) |
products[].items[].originalPrice | string | optional | Original or strikethrough price |
products[].items[].score | string | optional | Rating |
products[].items[].ratingsCount | string | optional | Review count |
products[].items[].describe | string | optional | Product description |
errmsg | string | optional | Upstream status message returned by the provider. |
msg | string | optional | Provider-specific status message. |
message | string | optional | Provider-specific message. |
title | string | optional | Provider-specific response title. |
sourceType | string | optional | Provider-specific source platform type. |
sourceTool | string | optional | Provider-specific source tool name. |
page | integer | optional | Current page returned by the upstream provider. |
pageSize | integer | optional | Page size returned by the upstream provider. |
pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. |
totalPage | integer | optional | Total page count returned by the upstream provider. |
dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. |
Response example
Direct response payload. No extra wrapper is added.
{
"data": [
{
"followUpQuestions": [],
"products": []
}
],
"resultsNum": 1,
"errcode": 1,
"costTime": 1,
"costToken": 1,
"taskId": "example-id",
"products": [
{
"items": [
{
"asin": "B072MQ5BRX",
"url": "https://example.com/image.jpg"
}
]
}
]
}Responses
| Code | Description |
|---|---|
| 200 | API executed successfully. Body is the direct response payload. |
| 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.