Nexscope

Amazon Search Intelligence SF: keyword Summary API

Use Amazon Search Intelligence SF: keyword Summary API through Nexscope with documented parameters, structured results and API key authentication.

CostRecent 19 credits / call
Try online
POST · https://api.nexscope.ai/sf/keywordSummaryMCP · nexscope_data_sf_keyword_summary
Amazon Search Intelligence SF

What this API does

Use Amazon Search Intelligence SF: keyword Summary API through Nexscope with documented parameters, structured results and API key authentication. The request accepts searchKeyword, country, asins, condition, last7d. Its documented result includes title, asin, productTitle, productImageUrl, productPrice, customerRatingCount, productStarRating, productRatingScore.

Amazon Search Intelligence SF: keyword Summary API API use cases

Build a keyword shortlist

To build a keyword shortlist, a marketplace analyst submits searchKeyword and country to Amazon Search Intelligence SF: keyword Summary API. The returned title, asin, productTitle help choose candidate search terms for further investigation.

Compare search demand signals

A marketplace analyst uses Amazon Search Intelligence SF: keyword Summary API with searchKeyword and country to compare search demand signals. The returned title, asin, productTitle help compare keyword demand within the requested market scope.

Plan a content or advertising test

For this workflow, a marketplace analyst calls Amazon Search Intelligence SF: keyword Summary API with searchKeyword and country to plan a content or advertising test. The result helps select terms for a content or advertising experiment.

Amazon Search Intelligence SF: keyword Summary API API FAQ

What does the Amazon Search Intelligence SF: keyword Summary API API return?

Use Amazon Search Intelligence SF: keyword Summary API through Nexscope with documented parameters, structured results and API key authentication. The documented output includes title, asin, productTitle, productImageUrl, productPrice, customerRatingCount, productStarRating, productRatingScore. It corresponds to the supplied searchKeyword, country, asins, condition, last7d. 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 Search Intelligence SF: keyword Summary API API cost?

The current documented cost is Recent 19 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 Search Intelligence SF: keyword Summary API API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/sf/keywordSummary 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_data_sf_keyword_summary. The same documented request parameters apply; use Online test to review a request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/sf/keywordSummary
MCP method
nexscope_data_sf_keyword_summary

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/sf/keywordSummary

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/sf/keywordSummary' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asins": "B01NBNDC1T,B09VLJJPL6",
  "country": "US",
  "pageSize": 50,
  "searchKeyword": "wireless charger"
}'

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
200HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
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.
All categories/ Amazon Search Intelligence SF
POSThttps://api.nexscope.ai/sf/keywordSummary

Run this API

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

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/sf/keywordSummary
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
searchKeywordstringrequired
Search keywords, maximum length 1000; try to use the target site language
countrystringoptional
Site: `US`, `UK`, `DE`, `CA`, `JP`, `FR`, `ES`, `IT`, `MX`, `AU`, `AE`, `BR`, `SA`
Example: US
asinsstringoptional
ASIN filter list, comma separated; maximum length 1000
conditionstringoptional
Only one condition can be passed at a time: `nfPosition`, `isSpAd`, `isVedioAd`, `isBrandAd`, `isPPCAd`, `isSearchRecommend`、`acAd`、`totalPeriod.in`、`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 take the last 7 days; when it is `false`, use the date range
Example: true
startDatestringoptional
`yyyy-MM-dd`; takes effect when `last7d=false`
endDatestringoptional
`yyyy-MM-dd`; works with `startDate`
sortBystringoptional
`totalKeywordNum`、`naturalKeywordNum`、`brandKeywordNum`、`vedioKeywordNum`、`acKeywordNum`、`erKeywordNum`、`trKeywordNum`、`sumScore`、`totalNfScore`、`totalSpSocre`、`totalBrandScore`、`totalVedioScore`、`totalAcScore`、`totalTrScore`、`totalErScore`
pageNumintegeroptional
Page number
Example: 1
pageSizeintegeroptional
Number per page, range 10–100
Example: 100
descbooleanoptional
Is descending order
Example: true

Code example

{
  "asins": "B01NBNDC1T,B09VLJJPL6",
  "country": "US",
  "pageSize": 50,
  "searchKeyword": "wireless charger"
}

Response example

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

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Response fields

Response field reference (55 fields)

NameTypeRequiredDescription
codestringoptional
sf business return code, `"1"` indicates success
msgstringoptional
news
totalintegeroptional
The actual amount of data returned this time
dataarrayoptional
ASIN keyword traffic data array
columnsarrayoptional
render column
typestringoptional
rendering style
titlestringoptional
Title
costTimeintegeroptional
Time consuming (ms)
costTokenintegeroptional
Consume token
asinstringoptional
ASIN code
productTitlestringoptional
Product title
productImageUrlstringoptional
Main image URL
productPricenumberoptional
Product selling price
customerRatingCountintegeroptional
Total customer ratings
productStarRatingnumberoptional
Product star rating
productRatingScorenumberoptional
Product rating value
productUpdateTimestringoptional
Product update time
dataPeriodStartDatestringoptional
Data period start date
totalExposureScorenumberoptional
Total exposure score
totalExposureRationumberoptional
Total traffic share
naturalSearchExposureScorenumberoptional
Total organic search exposure score
naturalSearchExposureRationumberoptional
Natural search exposure ratio
sponsoredProductsExposureScorenumberoptional
SP ad impression total score
sponsoredProductsExposureRationumberoptional
SP advertising exposure ratio
brandAdExposureScorenumberoptional
Total brand advertising exposure score
brandAdExposureRationumberoptional
Brand advertising exposure proportion
videoAdExposureScorenumberoptional
Total video ad exposure score
videoAdExposureRationumberoptional
Video ad exposure ratio
amazonsChoiceExposureScorenumberoptional
AC exposure total score
amazonsChoiceExposureRationumberoptional
AC exposure ratio
editorialRecommendationsExposureScorenumberoptional
ER total exposure score
editorialRecommendationsExposureRationumberoptional
ER exposure ratio
topRatedExposureScorenumberoptional
TR exposure total score
topRatedExposureRationumberoptional
TR exposure ratio
recommendPositionExposureScorenumberoptional
Recommended position exposure total score
recommendAdExposureScorenumberoptional
Recommended advertising exposure score
recommendAdExposureRationumberoptional
Recommended advertising traffic share
recommendNonadExposureScorenumberoptional
Recommended position non-advertising exposure score
recommendNonadExposureRationumberoptional
Recommended non-advertising traffic share
comprehensiveNaturalExposureScorenumberoptional
Comprehensive organic traffic score
comprehensiveNaturalExposureRationumberoptional
Combined organic traffic share
keywordTotalExposureScorenumberoptional
The total score of this keyword
keywordNaturalExposureScorenumberoptional
Natural score for this keyword
keywordSponsoredProductsExposureScorenumberoptional
SP score of this keyword
keywordBrandAdExposureScorenumberoptional
Brand advertising score for this keyword
keywordVideoAdExposureScorenumberoptional
Video ad score for this keyword
keywordAmazonsChoiceExposureScorenumberoptional
AC score of this keyword
keywordRecommendExposureScorenumberoptional
Recommended position score for this keyword
keywordRecommendAdExposureScorenumberoptional
Advertising score for recommended positions for this keyword
keywordRecommendNonadExposureScorenumberoptional
This keyword recommendation position is not an advertising score
keywordComprehensiveNaturalExposureScorenumberoptional
Comprehensive natural score for this keyword
ppcTrafficSourcesarrayoptional
PPC Traffic Source Tags
naturalSearchTrafficSourcesarrayoptional
Organic search traffic source tag
amazonRecommendationSourcesarrayoptional
Amazon Recommended Source Mark
promotionalDealSourcesarrayoptional
Promotion source tag

Responses

CodeDescription
200HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
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.

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_data_sf_keyword_summary",
    "arguments": {
      "asins": "B01NBNDC1T,B09VLJJPL6",
      "country": "US",
      "pageSize": 50,
      "searchKeyword": "wireless charger"
    }
  }
}

Legacy MCP v1

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

GET / POST /mcp/legacy

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.

12 credits / callAPI usage records

Try it

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

Endpoint
/sf/keywordSummary
MCP method
nexscope_data_sf_keyword_summary
cURL
curl -X POST \
  https://api.nexscope.ai/sf/keywordSummary \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "asins": "B01NBNDC1T,B09VLJJPL6", "country": "US", "pageSize": 50, "searchKeyword": "wireless charger" }'
Response
No response yet. Run the request to see the response here.

Related APIs