Amazon Marketplace Intelligence

Amazon Alexa Search

Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context. Trigger when the user mentions Amazon Alexa, Alexa shopping assistant, Amazon smart assistant, AI shopping guide, conversational product selection, natural language shopping, Amazon chat Q&A, Amazon Alexa shopping, conversational shopping, AI shopping assistant, follow-up questions, product recommendation conversation, context follow-ups. Even if the user does not explicitly mention "Alexa", if their need is to "ask for product recommendations on Amazon using natural language", this skill should also be triggered.

post/api/skill-api/v1/skills/amazon-alexa-search/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-alexa-search/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

promptsstring[] 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

formatstring

Response format: markdown (default) returns a readable report; json returns a structured data array

urlstring

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 request

{
  "prompts": [
    "What are good phone cases for iPhone?"
  ],
  "format": "markdown"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "data": [],
    "resultsNum": 1,
    "costTime": 1,
    "costToken": 1,
    "taskId": "example-id"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.