Nexscope
Start free

Keyword & Search Demand

Amazon Keyword Overview MCP Tool

SIF overview analysis of Amazon keyword market competition.

MCP tool name
nexscope_amazon_keyword_overview
Legacy MCP endpoint
/api/skill-api/v1/mcp
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-keyword-overview-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_overview",
    "arguments": {
      "country": "US",
      "keyword": "phone case",
      "last7d": true
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-keyword-overview

Arguments

NameTypeRequiredMeaning
keywordstringrequired
Keyword, translate to the corresponding country's language whenever possible. Max length: 1000 characters
Example: phone case
countrystringoptional
Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA
Example: {}
last7dbooleanoptional
Whether to get last 7 days data, default true. When false, use startDate/endDate range
Example: true
startDatestringoptional
Start date yyyy-MM-dd (effective when last7d=false)
Example: 2026-01-01
endDatestringoptional
End date yyyy-MM-dd (paired with startDate)
Example: 2026-01-01

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.totalintegeroptional
Total data count. Note: this endpoint typically returns only a single record, total is usually 1
Example: 1
data.dataarrayoptional
Return data (see data fields below)
Example: []
data.costTimeintegeroptional
Latency (ms)
Example: 1
data.costTokenintegeroptional
Tokens consumed
Example: 1
data.columnsarrayoptional
Render columns
Example: []
data.typestringoptional
Render style
Example: null
data.titlestringoptional
Title
Example: null
data.data[].keywordstringoptional
Keyword. The keyword text of the search query
Example: phone case
data.data[].keywordPopularityRankintegeroptional
Keyword popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume
Example: 1
data.data[].estimatedWeeklySearchVolumeintegeroptional
Estimated weekly search volume. Estimated weekly search count for this keyword on Amazon, reflecting its search popularity
Example: 1
data.data[].supplyDemandRationumberoptional
Supply-demand ratio. Ratio of supply to demand, formula: search result product count / monthly search volume; lower values indicate less competition and greater opportunity
Example: 1
data.data[].totalSearchResultProductCountintegeroptional
Total search result product count. Total number of products displayed for this keyword (including natural search, ad placements, recommendation placements, etc.)
Example: 1
data.data[].naturalSearchProductCountintegeroptional
Natural search product count. Number of products displayed in natural search results for this keyword (excluding ad placements)
Example: 1
data.data[].sponsoredProductsCountintegeroptional
SP ad product count. Number of products running Sponsored Products ads for this keyword
Example: 1
data.data[].brandAdProductCountintegeroptional
Brand ad product count. Number of products running brand ads for this keyword
Example: 1
data.data[].videoAdProductCountintegeroptional
Video ad product count. Number of products running video ads for this keyword
Example: 1
data.data[].paidAdvertisingProductCountintegeroptional
Total PPC ad product count. Total number of products running any PPC paid ads for this keyword (including SP, brand ads, video ads, etc.)
Example: 1
data.data[].amazonChoiceProductCountintegeroptional
Amazon's Choice product count. Number of products with the Amazon's Choice badge for this keyword
Example: 1
data.data[].topRatedProductCountintegeroptional
Top Rated recommended product count. Number of products appearing in the Top Rated (high rating) recommendation placement for this keyword
Example: 1
data.data[].searchRecommendationProductCountintegeroptional
Search recommendation product count. Number of products recommended by Amazon when searching this keyword
Example: 1
data.data[].editorialRecommendationsProductCountintegeroptional
Editorial Recommendations product count. Number of products appearing in the editorial recommendation placement for this keyword
Example: 1
data.data[].recNonadProductCountintegeroptional
Recommendation placement non-ad product count. Number of non-ad (organic) products in recommendation placements for this keyword
Example: 1
data.data[].recAdProductCountintegeroptional
Recommendation placement ad product count. Number of ad products in recommendation placements for this keyword
Example: 1
data.data[].trackedAsinTotalCountintegeroptional
SIF tracked ASIN deduplicated total count. Deduplicated count of ASINs that SIF has tracked with exposure scores across all positions (natural/ad/recommendation) for this keyword (upstream field: totalAsinNum)
Example: 1
data.data[].totalMarketplaceKeywordCountintegeroptional
Total marketplace keyword count. Total number of keywords for this site, used to understand overall market size
Example: 1
data.data[].dataPeriodStartDatestringoptional
Data period start date. ABA week start date corresponding to the returned data (yyyy-MM-dd)
Example: 2026-01-01
data.data[].dataPeriodEndDatestringoptional
Data period end date. ABA week end date corresponding to the returned data (yyyy-MM-dd)
Example: 2026-01-01
data.data[].keywordDataUpdateTimestringoptional
Keyword data update time
Example: phone case
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "country": "US",
  "keyword": "phone case",
  "last7d": true
}

Example structuredContent

{
  "data": {
    "total": 1,
    "data": [
      {
        "keyword": "phone case",
        "keywordPopularityRank": 1,
        "estimatedWeeklySearchVolume": 1,
        "supplyDemandRatio": 1,
        "totalSearchResultProductCount": 1,
        "naturalSearchProductCount": 1,
        "sponsoredProductsCount": 1,
        "brandAdProductCount": 1,
        "videoAdProductCount": 1,
        "paidAdvertisingProductCount": 1,
        "amazonChoiceProductCount": 1,
        "topRatedProductCount": 1,
        "searchRecommendationProductCount": 1,
        "editorialRecommendationsProductCount": 1,
        "recNonadProductCount": 1,
        "recAdProductCount": 1,
        "trackedAsinTotalCount": 1,
        "totalMarketplaceKeywordCount": 1,
        "dataPeriodStartDate": "2026-01-01",
        "dataPeriodEndDate": "2026-01-01",
        "keywordDataUpdateTime": "phone case"
      }
    ],
    "costTime": 1,
    "costToken": 1,
    "columns": []
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}