Amazon Search Intelligence SF

Amazon ASIN Traffic Summary

Compare traffic sources and keyword changes for an ASIN. Call the Amazon ASIN Traffic Summary API via REST or MCP from 12 credits per call.

MCP tool name

nexscope_amazon_asin_traffic_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": "amazon-asin-traffic-summary-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_asin_traffic_summary",
    "arguments": {
      "country": "US",
      "desc": true,
      "last7d": true,
      "pageNum": 1,
      "pageSize": 10,
      "searchValue": "B072MQ5BRX"
    }
  }
}

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	Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters Example: B072MQ5BRX
`country`	`string`	optional	Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA Example: {}
`last7d`	`boolean`	optional	Whether to get last 7 days data, default true. When false, use startDate/endDate range Example: false
`startDate`	`string`	optional	Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used) Example: 2026-01-01
`endDate`	`string`	optional	End date yyyy-MM-dd (paired with startDate) Example: 2026-01-01
`conditions`	`string`	optional	Condition filters, comma-separated. Options: nf (natural traffic), sp (SP ads), sb (SB regular), sbv (video ads), ad (ad traffic), acAd (SP recommendation), totalPeriod.in (new incoming traffic keywords) Example: {}
`sortBy`	`string`	optional	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 (total natural rank exposure score), totalSpSocre (total SP ad exposure score, note spelling), totalBrandScore (total brand ad exposure score), totalVedioScore (total video ad exposure score), totalAcScore (total AC recommendation exposure score), totalTrScore (total TR recommendation exposure score), totalErScore (total ER recommendation exposure score) Example: {}
`pageNum`	`integer`	optional	Page number, default 1 Example: 1
`pageSize`	`integer`	optional	Results per page, min 10, max 10000, default 10000 Example: 10
`desc`	`boolean`	optional	Whether to sort descending, default true Example: false

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",
  "desc": true,
  "last7d": true,
  "pageNum": 1,
  "pageSize": 10,
  "searchValue": "B072MQ5BRX"
}

Example structuredContent

{}