Keyword & Search Demand

Amazon Keyword Search History

Nexscope keyword historical search volume query, returning Amazon keyword exact search volume trends in 7-day periods, covering 10 marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword search volume trends, historical search volume, search popularity changes, keyword seasonality, search volume fluctuations, Nexscope search volume, keyword search volume history, keyword trend, search volume over time, seasonal search volume, keyword popularity trend. Even if the user does not explicitly mention "Nexscope", if their need involves viewing the search volume trend of an Amazon keyword over time, this skill should also be triggered.

post/api/skill-api/v1/skills/amazon-keyword-search-history/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-search-history/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

marketplacestring required

Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp

keywordstring required

Keyword to query

startDatestring required

Start date (format: YYYY-MM-DD)

endDatestring required

End date (format: YYYY-MM-DD); max interval from startDate is 366 days

Example request

{
  "marketplace": "us",
  "endDate": "2025-03-31",
  "keyword": "phone case",
  "startDate": "2026-01-01"
}

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": {
    "costToken": 1,
    "historicalSearchVolumeList": []
  }
}

Changes

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