Amazon Search Intelligence SF

Amazon Search Intelligence SF: keyword Summary API

Amazon Search Intelligence SF: keyword Summary API.

MCP tool name

nexscope_data_sf_keyword_summary

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-sf-keyword-summary-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_sf_keyword_summary",
    "arguments": {
      "asins": "B01NBNDC1T,B09VLJJPL6",
      "country": "US",
      "pageSize": 50,
      "searchKeyword": "wireless charger"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`searchKeyword`	`string`	required	Search keywords, maximum length 1000; try to use the target site language Example: {}
`country`	`string`	optional	Site: `US`, `UK`, `DE`, `CA`, `JP`, `FR`, `ES`, `IT`, `MX`, `AU`, `AE`, `BR`, `SA` Example: US
`asins`	`string`	optional	ASIN filter list, comma separated; maximum length 1000 Example: {}
`condition`	`string`	optional	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` Example: {}
`last7d`	`boolean`	optional	Whether to take the last 7 days; when it is `false`, use the date range Example: true
`startDate`	`string`	optional	`yyyy-MM-dd`; takes effect when `last7d=false` Example: {}
`endDate`	`string`	optional	`yyyy-MM-dd`; works with `startDate` Example: {}
`sortBy`	`string`	optional	`totalKeywordNum`、`naturalKeywordNum`、`brandKeywordNum`、`vedioKeywordNum`、`acKeywordNum`、`erKeywordNum`、`trKeywordNum`、`sumScore`、`totalNfScore`、`totalSpSocre`、`totalBrandScore`、`totalVedioScore`、`totalAcScore`、`totalTrScore`、`totalErScore` Example: {}
`pageNum`	`integer`	optional	Page number Example: 1
`pageSize`	`integer`	optional	Number per page, range 10–100 Example: 100
`desc`	`boolean`	optional	Is descending order Example: true

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`string`	optional	sf business return code, `"1"` indicates success Example: {}
`msg`	`string`	optional	news Example: {}
`total`	`integer`	optional	The actual amount of data returned this time Example: {}
`data`	`array`	optional	ASIN keyword traffic data array Example: {}
`columns`	`array`	optional	render column Example: {}
`type`	`string`	optional	rendering style Example: {}
`title`	`string`	optional	Title Example: {}
`costTime`	`integer`	optional	Time consuming (ms) Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`asin`	`string`	optional	ASIN code Example: {}
`productTitle`	`string`	optional	Product title Example: {}
`productImageUrl`	`string`	optional	Main image URL Example: {}
`productPrice`	`number`	optional	Product selling price Example: {}
`customerRatingCount`	`integer`	optional	Total customer ratings Example: {}
`productStarRating`	`number`	optional	Product star rating Example: {}
`productRatingScore`	`number`	optional	Product rating value Example: {}
`productUpdateTime`	`string`	optional	Product update time Example: {}
`dataPeriodStartDate`	`string`	optional	Data period start date Example: {}
`totalExposureScore`	`number`	optional	Total exposure score Example: {}
`totalExposureRatio`	`number`	optional	Total traffic share Example: {}
`naturalSearchExposureScore`	`number`	optional	Total organic search exposure score Example: {}
`naturalSearchExposureRatio`	`number`	optional	Natural search exposure ratio Example: {}
`sponsoredProductsExposureScore`	`number`	optional	SP ad impression total score Example: {}
`sponsoredProductsExposureRatio`	`number`	optional	SP advertising exposure ratio Example: {}
`brandAdExposureScore`	`number`	optional	Total brand advertising exposure score Example: {}
`brandAdExposureRatio`	`number`	optional	Brand advertising exposure proportion Example: {}
`videoAdExposureScore`	`number`	optional	Total video ad exposure score Example: {}
`videoAdExposureRatio`	`number`	optional	Video ad exposure ratio Example: {}
`amazonsChoiceExposureScore`	`number`	optional	AC exposure total score Example: {}
`amazonsChoiceExposureRatio`	`number`	optional	AC exposure ratio Example: {}
`editorialRecommendationsExposureScore`	`number`	optional	ER total exposure score Example: {}
`editorialRecommendationsExposureRatio`	`number`	optional	ER exposure ratio Example: {}
`topRatedExposureScore`	`number`	optional	TR exposure total score Example: {}
`topRatedExposureRatio`	`number`	optional	TR exposure ratio Example: {}
`recommendPositionExposureScore`	`number`	optional	Recommended position exposure total score Example: {}
`recommendAdExposureScore`	`number`	optional	Recommended advertising exposure score Example: {}
`recommendAdExposureRatio`	`number`	optional	Recommended advertising traffic share Example: {}
`recommendNonadExposureScore`	`number`	optional	Recommended position non-advertising exposure score Example: {}
`recommendNonadExposureRatio`	`number`	optional	Recommended non-advertising traffic share Example: {}
`comprehensiveNaturalExposureScore`	`number`	optional	Comprehensive organic traffic score Example: {}
`comprehensiveNaturalExposureRatio`	`number`	optional	Combined organic traffic share Example: {}
`keywordTotalExposureScore`	`number`	optional	The total score of this keyword Example: {}
`keywordNaturalExposureScore`	`number`	optional	Natural score for this keyword Example: {}
`keywordSponsoredProductsExposureScore`	`number`	optional	SP score of this keyword Example: {}
`keywordBrandAdExposureScore`	`number`	optional	Brand advertising score for this keyword Example: {}
`keywordVideoAdExposureScore`	`number`	optional	Video ad score for this keyword Example: {}
`keywordAmazonsChoiceExposureScore`	`number`	optional	AC score of this keyword Example: {}
`keywordRecommendExposureScore`	`number`	optional	Recommended position score for this keyword Example: {}
`keywordRecommendAdExposureScore`	`number`	optional	Advertising score for recommended positions for this keyword Example: {}
`keywordRecommendNonadExposureScore`	`number`	optional	This keyword recommendation position is not an advertising score Example: {}
`keywordComprehensiveNaturalExposureScore`	`number`	optional	Comprehensive natural score for this keyword Example: {}
`ppcTrafficSources`	`array`	optional	PPC Traffic Source Tags Example: {}
`naturalSearchTrafficSources`	`array`	optional	Organic search traffic source tag Example: {}
`amazonRecommendationSources`	`array`	optional	Amazon Recommended Source Mark Example: {}
`promotionalDealSources`	`array`	optional	Promotion source tag Example: {}

Examples

Example arguments

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

Example structuredContent

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