Nexscope

Amazon Keyword Intelligence

Explore weekly Amazon Brand Analytics search-term data. Call the Amazon Keyword Intelligence API via REST or MCP from 10 credits per call.

CostRecent Avg. 12 · Range 10–26 credits / call
Try online
POST · https://api.nexscope.ai/aba/intelligentQueryMCP · nexscope_amazon_keyword_intelligence

What this API does

Explore weekly Amazon Brand Analytics search-term data. The request accepts analysisDescription, region, createDownloadUrl. Its documented result includes success, tables, downloadUrl, downloadNote, name, searchTerm, reportStartDate, region.

Amazon Keyword Intelligence API use cases

Build a keyword shortlist

To build a keyword shortlist, a marketplace analyst submits analysisDescription and region to Amazon Keyword Intelligence. The returned success, tables, downloadUrl help choose candidate search terms for further investigation.

Compare search demand signals

A marketplace analyst uses Amazon Keyword Intelligence with analysisDescription and region to compare search demand signals. The returned success, tables, downloadUrl help compare keyword demand within the requested market scope.

Plan a content or advertising test

For this workflow, a marketplace analyst calls Amazon Keyword Intelligence with analysisDescription and region to plan a content or advertising test. The result helps select terms for a content or advertising experiment.

Amazon Keyword Intelligence API FAQ

What does the Amazon Keyword Intelligence API return?

Explore weekly Amazon Brand Analytics search-term data. The documented output includes success, tables, downloadUrl, downloadNote, name, searchTerm, reportStartDate, region. It corresponds to the supplied analysisDescription, region, createDownloadUrl. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the Amazon Keyword Intelligence API cost?

The current documented cost is Recent Avg. 12 · Range 10–26 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Amazon Keyword Intelligence API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/aba/intelligentQuery with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_amazon_keyword_intelligence. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/aba/intelligentQuery
MCP method
nexscope_amazon_keyword_intelligence

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/aba/intelligentQuery

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/aba/intelligentQuery' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "analysisDescription": "Find the search popularity rankings for the keyword gift in the US marketplace over the past 12 weeks.",
  "createDownloadUrl": false,
  "region": "US"
}'

Code example

{
  "analysisDescription": "Find the search popularity rankings for the keyword gift in the US marketplace over the past 12 weeks.",
  "createDownloadUrl": false,
  "region": "US"
}

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.
All categories/ Amazon ABA & Business Insights
POSThttps://api.nexscope.ai/aba/intelligentQuery

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/aba/intelligentQuery
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
analysisDescriptionstringrequired
Natural language that accurately describes query intent.
regionstringoptional
Amazon site code. Optional values: `US`, `DE`, `BR`, `CA`, `AU`, `JP`, `AE`, `ES`, `FR`, `IT`, `SA`, `TR`, `MX`, `SE`, `NL`.
Example: US
createDownloadUrlbooleanoptional
Whether to generate a CSV download link; set to `true` when explicitly required to download, export or generate files.
Example: false

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

No response example is published for this API. Refer to the response fields below.

Response fields

Response field reference (21 fields)

NameTypeRequiredDescription
successbooleanoptional
Whether the query is successful.
tablesarrayoptional
Resulting data array; each element contains `data` (data row), `columns` (column definition), and `name` (sheet name).
totalintegeroptional
Total number of results.
downloadUrlstringoptional
The CSV file address returned when `createDownloadUrl` is `true`.
msgstringoptional
Additional message.
downloadNotestringoptional
Tips for downloading.
codestringoptional
Return code.
costTimeintegeroptional
Time taken, in milliseconds.
costTokenintegeroptional
The token consumed by this call.
dataarrayoptional
Query result data rows. The actual columns will vary depending on the query conditions.
columnsarrayoptional
Result column definition.
namestringoptional
Sheet name.
searchTermstringoptional
Consumer search keywords.
reportStartDatestringoptional
The start date of the data collection week.
regionstringoptional
Amazon site code.
searchFrequencyRankintegeroptional
Search popularity ranking; the smaller the value, the higher the search popularity, and 1 is the most popular.
clickedAsinstringoptional
The ASIN of the clicked product.
clickedItemNamestringoptional
The clicked product name.
clickShareRankintegeroptional
The click share ranking of this ASIN under this search term.
clickSharenumberoptional
The click share received by this ASIN, ranging from 0 to 1.
conversionSharenumberoptional
The conversion share obtained by this ASIN, ranging from 0 to 1.

Responses

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

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.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_intelligence",
    "arguments": {
      "analysisDescription": "Find Amazon Brand Analytics search demand for phone case in the US marketplace",
      "createDownloadUrl": false,
      "region": "US"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Data Example

Request parameters

{
  "analysisDescription": "List the top 40 Amazon search terms by Brand Analytics search frequency rank (smaller rank = higher search volume) for the most recent available report week in the US marketplace, restricted to search terms containing or closely matching any of: door handle kit, trim replacement kit, auto interior accessories, car trim panel, replacement car parts interior. For each term return reportStartDate, searchTerm, searchFrequencyRank, and the top clicked ASINs with clickedAsin, clickedItemName, clickShare and conversionShare.",
  "region": "US",
  "createDownloadUrl": false
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "tables": [
      {
        "data": [
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          }
        ],
        "columns": [
          {
            "filterable": true,
            "cellType": "text",
            "field": "reportstartdate",
            "sortable": true,
            "title": "reportstartdate"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "searchterm",
            "sortable": true,
            "title": "searchterm"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "searchfrequencyrank",
            "sortable": true,
            "title": "searchfrequencyrank"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickedasin",
            "sortable": true,
            "title": "clickedasin"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickeditemname",
            "sortable": true,
            "title": "clickeditemname"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "clickShare",
            "description": "该ASIN获得的点击数占该搜索词总点击数的比例,取值范围:0-1",
            "sortable": true,
            "title": "点击占比"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "conversionShare",
            "description": "该ASIN获得的购买数占该搜索词总购买数的比例,取值范围:0-1",
            "sortable": true,
            "title": "转化占比"
          }
        ],
        "name": "美国站最新一周汽车内饰配件相关搜索词Top 40",
        "userExplanation": "筛选美国站最新一周的数据,查找包含以下任一短语的搜索词:door handle kit(门把手套件)、trim replacement kit(装饰条更换套件)、auto interior accessories(汽车内饰配件)、car trim panel(汽车装饰板)、replacement car parts interior(内饰替换配件)。按搜索频率排名升序排列,返回排名前40的搜索词,以及每个搜索词对应的被点击ASIN、商品名称、点击占比和转化占比。站点:美国站。返回数量:40个搜索词。",
        "analysisStatement": ""
      }
    ],
    "total": 6,
    "downloadNote": "如需下载结果,请在消息栏发\"下载CSV文件\"告诉我。",
    "costTime": 44428,
    "success": true,
    "type": "tablesListWorkbenches",
    "title": "数据挖掘结果"
  }
}

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

Recent Avg. 12 · Range 10–26 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint
/aba/intelligentQuery
MCP method
nexscope_amazon_keyword_intelligence
cURL
curl -X POST \
  https://api.nexscope.ai/aba/intelligentQuery \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "analysisDescription": "Find the search popularity rankings for the keyword gift in the US marketplace over the past 12 weeks.", "createDownloadUrl": false, "region": "US" }'
Response
No response yet. Run the request to see the response here.

Related APIs