Nexscope logo
Start free

Amazon Keyword Summary API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Keyword & Search Demand

API overview

Break down all competitor ASIN traffic sources under a given keyword -- organic search, SP ads, SB brand ads, SBV video ads, SP recommendations, AC/ER/TR recommendation slots, with support for ASIN filtering, custom date ranges, and new traffic keyword filters.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run
MCP method
nexscope_amazon_keyword_summary

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 .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run

Run an API

Request parameters documented by ecommerce.amazon-keyword-summary.

Slugamazon-keyword-summary
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "last7d": true,   "pageSize": 10,   "searchKeyword": "phone case",   "country": "US",   "pageNum": 1 }'
All categories/ Keyword & Search Demand
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run

Run this API

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

Open tester

Endpoint

MethodPOST
Pathhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
searchKeywordstringrequired
Search 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
asinsstringoptional
ASIN filter list, comma-separated; if not provided, returns all ASINs for this keyword. Max length 1000 characters
Example: B072MQ5BRX
conditionstringoptional
Condition filter, only one at a time.<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (search recommendation keyword), acAd (SP recommendation)<br>Period count type: totalPeriod.in (new incoming traffic keywords), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total / .in
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; if omitted, the latest system full week is used)
Example: 2026-01-01
endDatestringoptional
End date yyyy-MM-dd (paired with startDate)
Example: 2026-01-01
sortBystringoptional
Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore, totalSpSocre (note spelling), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore
pageNumintegeroptional
Page number, default 1
Example: 1
pageSizeintegeroptional
Results per page, min 10, max 100, default 100
Example: 10
descbooleanoptional
Whether to sort descending, default true
Example: true

Request example

{
  "last7d": true,
  "pageSize": 10,
  "searchKeyword": "phone case",
  "country": "US",
  "pageNum": 1
}

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
codestringoptional
Response code
msgstringoptional
Message
totalintegeroptional
Number of data records actually returned
Example: 1
dataarrayoptional
Return data, array of product keyword traffic data objects
Example: []
columnsarrayoptional
Render columns
Example: []
typestringoptional
Render style
titlestringoptional
Title
costTimeintegeroptional
Latency (ms)
Example: 1
costTokenintegeroptional
Tokens consumed
Example: 1
data[].asinstringoptional
ASIN code
Example: B072MQ5BRX
data[].productTitlestringoptional
Product title
data[].productImageUrlstringoptional
Product main image URL
Example: https://example.com/image.jpg
data[].productPricenumberoptional
Product price
Example: 1
data[].customerRatingCountintegeroptional
Total customer rating count
Example: 1
data[].productStarRatingnumberoptional
Product star rating (0-5 stars)
Example: 1
data[].productRatingScorenumberoptional
Product rating score value
Example: 1
data[].productUpdateTimestringoptional
Product update time (yyyy-MM-dd HH:mm:ss)
Example: 2026-01-01
data[].dataPeriodStartDatestringoptional
Data period start date (yyyy-MM-dd)
Example: 2026-01-01
data[].totalExposureScorenumberoptional
Total exposure score
Example: 1
data[].totalExposureRationumberoptional
Total traffic share
Example: 1
data[].naturalSearchExposureScorenumberoptional
Natural search exposure total score
Example: 1
data[].naturalSearchExposureRationumberoptional
Natural search exposure ratio
Example: 1
data[].sponsoredProductsExposureScorenumberoptional
SP ad exposure total score
Example: 1
data[].sponsoredProductsExposureRationumberoptional
SP ad exposure ratio
Example: 1
data[].brandAdExposureScorenumberoptional
Brand ad exposure total score
Example: 1
data[].brandAdExposureRationumberoptional
Brand ad exposure ratio
Example: 1
data[].videoAdExposureScorenumberoptional
Video ad exposure total score
Example: 1
data[].videoAdExposureRationumberoptional
Video ad exposure ratio
Example: 1
data[].amazonsChoiceExposureScorenumberoptional
AC exposure total score
Example: 1
data[].amazonsChoiceExposureRationumberoptional
AC exposure ratio
Example: 1
data[].editorialRecommendationsExposureScorenumberoptional
ER exposure total score
Example: 1
data[].editorialRecommendationsExposureRationumberoptional
ER exposure ratio
Example: 1
data[].topRatedExposureScorenumberoptional
TR exposure total score
Example: 1
data[].topRatedExposureRationumberoptional
TR exposure ratio
Example: 1
data[].recommendPositionExposureScorenumberoptional
Recommendation position exposure total score
Example: 1
data[].recommendAdExposureScorenumberoptional
Recommendation position ad exposure score
Example: 1
data[].recommendAdExposureRationumberoptional
Recommendation position ad traffic share
Example: 1
data[].recommendNonadExposureScorenumberoptional
Recommendation position non-ad exposure score
Example: 1
data[].recommendNonadExposureRationumberoptional
Recommendation position non-ad traffic share
Example: 1
data[].comprehensiveNaturalExposureScorenumberoptional
Comprehensive natural traffic score (natural search + recommendation non-ad)
Example: 1
data[].comprehensiveNaturalExposureRationumberoptional
Comprehensive natural traffic share
Example: 1
data[].keywordTotalExposureScorenumberoptional
Keyword total score
Example: 1
data[].keywordNaturalExposureScorenumberoptional
Keyword natural score
Example: 1
data[].keywordSponsoredProductsExposureScorenumberoptional
Keyword SP ad score
Example: 1
data[].keywordBrandAdExposureScorenumberoptional
Keyword brand ad score
Example: 1
data[].keywordVideoAdExposureScorenumberoptional
Keyword video ad score
Example: 1
data[].keywordAmazonsChoiceExposureScorenumberoptional
Keyword AC score
Example: 1
data[].keywordRecommendExposureScorenumberoptional
Keyword recommendation position score
Example: 1
data[].keywordRecommendAdExposureScorenumberoptional
Keyword recommendation position ad score
Example: 1
data[].keywordRecommendNonadExposureScorenumberoptional
Keyword recommendation position non-ad score
Example: 1
data[].keywordComprehensiveNaturalExposureScorenumberoptional
Keyword comprehensive natural score (natural + recommendation non-ad)
Example: 1
data[].ppcTrafficSourcesarrayoptional
PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads
Example: []
data[].naturalSearchTrafficSourcesarrayoptional
Natural search traffic source markers
Example: []
data[].amazonRecommendationSourcesarrayoptional
Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.
Example: []
data[].promotionalDealSourcesarrayoptional
Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.
Example: []
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
messagestringoptional
Provider-specific message.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "total": 1,
  "data": [
    {
      "asin": "B072MQ5BRX",
      "productImageUrl": "https://example.com/image.jpg",
      "productPrice": 1,
      "customerRatingCount": 1,
      "productStarRating": 1,
      "productRatingScore": 1,
      "productUpdateTime": "2026-01-01",
      "dataPeriodStartDate": "2026-01-01",
      "totalExposureScore": 1,
      "totalExposureRatio": 1,
      "naturalSearchExposureScore": 1,
      "naturalSearchExposureRatio": 1,
      "sponsoredProductsExposureScore": 1,
      "sponsoredProductsExposureRatio": 1,
      "brandAdExposureScore": 1,
      "brandAdExposureRatio": 1,
      "videoAdExposureScore": 1,
      "videoAdExposureRatio": 1,
      "amazonsChoiceExposureScore": 1,
      "amazonsChoiceExposureRatio": 1,
      "editorialRecommendationsExposureScore": 1,
      "editorialRecommendationsExposureRatio": 1,
      "topRatedExposureScore": 1,
      "topRatedExposureRatio": 1,
      "recommendPositionExposureScore": 1,
      "recommendAdExposureScore": 1,
      "recommendAdExposureRatio": 1,
      "recommendNonadExposureScore": 1,
      "recommendNonadExposureRatio": 1,
      "comprehensiveNaturalExposureScore": 1,
      "comprehensiveNaturalExposureRatio": 1,
      "keywordTotalExposureScore": 1,
      "keywordNaturalExposureScore": 1,
      "keywordSponsoredProductsExposureScore": 1,
      "keywordBrandAdExposureScore": 1,
      "keywordVideoAdExposureScore": 1,
      "keywordAmazonsChoiceExposureScore": 1,
      "keywordRecommendExposureScore": 1,
      "keywordRecommendAdExposureScore": 1,
      "keywordRecommendNonadExposureScore": 1,
      "keywordComprehensiveNaturalExposureScore": 1,
      "ppcTrafficSources": [],
      "naturalSearchTrafficSources": [],
      "amazonRecommendationSources": [],
      "promotionalDealSources": []
    }
  ],
  "columns": [],
  "costTime": 1,
  "costToken": 1
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

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.

Related APIs

Amazon Asin Keywords

Use SIF data to reverse-lookup traffic keywords for any Amazon ASIN, including organic ranking, ad ranking, search volume, traffic share, organic/paid scores, ABA TOP3 click concentration, click conversion rate, year-over-year search volume changes, and weekly/monthly time windows.

Amazon Keyword Expansion

Jungle Scout 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.

Amazon Keyword Intelligence

Query and analyze Amazon ABA (Brand Analytics) search term data, covering 15 marketplaces with nearly 3 years of weekly data.

Amazon Keyword Overview

SIF overview analysis of Amazon keyword market competition.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_summary",
    "arguments": {
      "last7d": true,
      "pageSize": 10,
      "searchKeyword": "phone case",
      "country": "US",
      "pageNum": 1
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

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

Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run
MCP method
nexscope_amazon_keyword_summary
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-summary/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "last7d": true, "pageSize": 10, "searchKeyword": "phone case", "country": "US", "pageNum": 1 }'
Response
No response yet. Run the request to see the response here.