Keyword & Search Demand

Amazon Keyword Expansion

Nexscope keyword expansion tool that expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other metrics, covering 10 Amazon marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword expansion, keyword mining, long-tail keyword mining, related keywords, keyword suggestions, keyword discovery, PPC bid research, keyword competition, keyword discovery, Nexscope keywords, keyword expansion, keyword discovery, keyword scout, related keywords, long-tail keywords, keyword suggestions, PPC bid research, keyword competition, seed keyword expansion, keyword mining. Even if the user does not explicitly mention "Nexscope", if their need involves finding more related keywords and their search volume, competition, and other metrics starting from a seed keyword, this skill should also be triggered.

post/api/skill-api/v1/skills/amazon-keyword-expansion/run

Request

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

searchTermsstring required

Seed keyword (single keyword string)

needCountinteger

Total number of results returned

sortstring

Sort field, default -monthly_search_volume_exact (exact search volume descending)

minMonthlySearchVolumeExactinteger

Minimum exact search volume

maxMonthlySearchVolumeExactinteger

Maximum exact search volume

minMonthlySearchVolumeBroadinteger

Minimum broad search volume

maxMonthlySearchVolumeBroadinteger

Maximum broad search volume

minWordCountinteger

Minimum word count for keywords (for filtering long-tail keywords)

maxWordCountinteger

Maximum word count for keywords

minOrganicProductCountinteger

Minimum organic product count

maxOrganicProductCountinteger

Maximum organic product count

Example request

{
  "needCount": 10,
  "searchTerms": "phone case",
  "marketplace": "us"
}

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,
    "keywordInfoList": []
  }
}

Changes

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