Amazon Search Intelligence SF

Amazon Search Intelligence SF: asin Summary API

Amazon Search Intelligence SF: asin Summary API.

MCP tool name

nexscope_data_sf_asin_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-asin-summary-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_sf_asin_summary",
    "arguments": {
      "country": "US",
      "pageSize": 10000,
      "searchValue": "B09V3KXJPB,B0BN1K7WJP"
    }
  }
}

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
`searchValue`	`string`	required	ASIN codes, multiple separated by commas, up to 10, maximum length 1000 characters Example: {}
`country`	`string`	optional	Site: `US`, `UK`, `DE`, `CA`, `JP`, `FR`, `ES`, `IT`, `MX`, `AU`, `AE`, `BR`, `SA` Example: US
`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: {}
`conditions`	`string`	optional	Comma separated: `nf`, `sp`, `sb`, `sbv`, `ad`, `acAd`, `totalPeriod.in` 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–10000 Example: 10000
`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	return code Example: {}
`msg`	`string`	optional	news Example: {}
`total`	`integer`	optional	The actual amount of data returned this time Example: {}
`data`	`array`	optional	ASIN summary object array (Field suffix convention: `Prev` is the value of the previous period; `In` / `*Out` is the number of new entries/exits in this cycle relative to the previous period) Example: {}
`columns`	`array`	optional	render column Example: {}
`type`	`string`	optional	rendering style Example: {}
`title`	`string`	optional	Title Example: {}
`isParentAsin`	`boolean`	optional	Whether the search object is a parent ASIN Example: {}
`variantsNum`	`integer`	optional	Number of variations with keywords Example: {}
`noKeywordVariantsNum`	`integer`	optional	Number of variations without keywords 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: {}
`productCategory`	`string`	optional	Product category Example: {}
`productPrice`	`number`	optional	Product selling price Example: {}
`productImageUrl`	`string`	optional	Main image URL Example: {}
`productFeatures`	`array`	optional	Product feature list Example: {}
`customerRatingCount`	`integer`	optional	Total customer ratings Example: {}
`productStarRating`	`number`	optional	Product star rating (0–5) Example: {}
`productRatingScore`	`number`	optional	Product rating value (0–5) Example: {}
`isVariantProduct`	`boolean`	optional	Is it a variant? Example: {}
`recentMonthlySalesBucket`	`string`	optional	Sales bucket in the past month; this field only has a value in the `keywordSummary` path, in the form of `"300+"` or `"1,000+"` Example: {}
`isMonitored`	`boolean`	optional	Has it been monitored? Example: {}
`monitoringStartTime`	`string`	optional	attention time Example: {}
`dataPeriodStartDate`	`string`	optional	Data period start date Example: {}
`totalExposureScore`	`number`	optional	Total exposure score Example: {}
`totalExposureScorePrev`	`number`	optional	Total exposure score last cycle Example: {}
`totalTrafficKeywordCount`	`integer`	optional	Total number of traffic keywords Example: {}
`totalTrafficKeywordCountIn`	`integer`	optional	Number of new traffic keywords this cycle Example: {}
`totalTrafficKeywordCountOut`	`integer`	optional	Number of exit traffic keywords this cycle Example: {}
`totalTrafficKeywordCountPrev`	`integer`	optional	Total number of traffic keywords in the last cycle Example: {}
`naturalSearchExposureScore`	`number`	optional	Total organic search exposure score Example: {}
`naturalSearchExposureRatio`	`number`	optional	Natural search exposure ratio Example: {}
`naturalSearchExposureScorePrev`	`number`	optional	Natural search exposure score last cycle Example: {}
`naturalSearchKeywordCount`	`integer`	optional	Number of natural search keywords Example: {}
`naturalSearchKeywordCountIn`	`integer`	optional	Number of new natural keywords this cycle Example: {}
`naturalSearchKeywordCountOut`	`integer`	optional	Number of natural keywords exiting this cycle Example: {}
`naturalSearchKeywordCountPrev`	`integer`	optional	Number of natural keywords in the previous cycle Example: {}
`sponsoredProductsExposureScore`	`number`	optional	SP ad impression total score Example: {}
`sponsoredProductsExposureRatio`	`number`	optional	SP advertising exposure ratio Example: {}
`sponsoredProductsExposureScorePrev`	`number`	optional	Last cycle SP exposure score Example: {}
`sponsoredProductsKeywordCount`	`integer`	optional	SP number of advertising keywords Example: {}
`brandAdExposureScore`	`number`	optional	Total brand advertising exposure score Example: {}
`brandAdExposureRatio`	`number`	optional	Brand advertising exposure proportion Example: {}
`brandAdExposureScorePrev`	`number`	optional	Brand advertising exposure score last cycle Example: {}
`brandAdKeywordCount`	`integer`	optional	Number of brand advertising keywords Example: {}
`topBrandAdKeywordCount`	`integer`	optional	Number of top brand ad keywords Example: {}
`bottomBrandAdKeywordCount`	`integer`	optional	Number of keywords for brand ads at the bottom Example: {}
`videoAdExposureScore`	`number`	optional	Total video ad exposure score Example: {}
`videoAdExposureRatio`	`number`	optional	Video ad exposure ratio Example: {}
`videoAdExposureScorePrev`	`number`	optional	Video ad exposure score last cycle Example: {}
`videoAdKeywordCount`	`integer`	optional	Number of video ad keywords Example: {}
`amazonsChoiceExposureScore`	`number`	optional	Amazon's Choice Impression Total Score Example: {}
`amazonsChoiceExposureRatio`	`number`	optional	Amazon's Choice impression share Example: {}
`amazonsChoiceExposureScorePrev`	`number`	optional	Last cycle AC exposure score Example: {}
`amazonsChoiceKeywordCount`	`integer`	optional	AC keyword count Example: {}
`amazonsChoiceKeywordCountIn`	`integer`	optional	Number of new AC keywords in this cycle Example: {}
`amazonsChoiceKeywordCountOut`	`integer`	optional	Number of AC keywords exiting this cycle Example: {}
`editorialRecommendationsExposureScore`	`number`	optional	ER total exposure score Example: {}
`editorialRecommendationsExposureRatio`	`number`	optional	ER exposure ratio Example: {}
`editorialRecommendationsKeywordCount`	`integer`	optional	ER keyword count Example: {}
`topRatedExposureScore`	`number`	optional	TR Recommended exposure total score Example: {}
`topRatedExposureRatio`	`number`	optional	TR recommended exposure ratio Example: {}
`topRatedKeywordCount`	`integer`	optional	TR keyword count Example: {}
`frequentlyBoughtKeywordCount`	`integer`	optional	Number of recommended keywords for high-frequency purchases Example: {}
`recommendPositionExposureScore`	`number`	optional	Recommended position exposure total score Example: {}
`recommendAdExposureScore`	`number`	optional	Recommended advertising exposure score Example: {}
`recommendNonadExposureScore`	`number`	optional	Recommended position non-advertising exposure score Example: {}
`nonAcRecommendExposureScore`	`number`	optional	Non-AC recommended position exposure score Example: {}
`recommendKeywordCount`	`integer`	optional	Total number of recommended keywords Example: {}
`recommendAdKeywordCount`	`integer`	optional	Number of recommended advertising keywords Example: {}
`recommendNonadKeywordCount`	`integer`	optional	Number of recommended non-advertising keywords 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

{
  "country": "US",
  "pageSize": 10000,
  "searchValue": "B09V3KXJPB,B0BN1K7WJP"
}

Example structuredContent

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