Amazon Intelligence SS

Amazon Intelligence SS: competitor lookup API

Amazon Intelligence SS: competitor lookup API.

MCP tool name

nexscope_data_ss_competitor_lookup

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-ss-competitor-lookup-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_ss_competitor_lookup",
    "arguments": {
      "keyword": "wireless earbuds",
      "marketplace": "US",
      "matchType": 1,
      "size": 20
    }
  }
}

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
`marketplace`	`string`	optional	Amazon site codes: `US`, `UK`, `DE`, `FR`, `JP`, `CA`, `IT`, `ES`, `MX`, `AU`, `TR`, `IN` Example: US
`keyword`	`string`	optional	Search keywords, it is recommended to use the target site language Example: {}
`asinList`	`string`	optional	ASIN, multiple ASINs separated by English commas, up to 40; format: `^[A-Z0-9]+(,[A-Z0-9]+){0,39}$` Example: {}
`sellerName`	`string`	optional	Seller name filter Example: {}
`brand`	`string`	optional	Brand name filter Example: {}
`nodeLabel`	`string`	optional	Amazon category name, supports multi-level category names, and the levels are separated by English colon `:` Example: {}
`nodeIdPath`	`string`	optional	Amazon Category ID Path Example: {}
`matchType`	`integer`	optional	Matching method: `1` phrase matching, `2` fuzzy matching, `3` precise matching Example: 1
`showVariation`	`string`	optional	Whether to query the variant: `Y` yes, `N` no Example: N
`dataSnapshotMonth`	`string`	optional	`nearly` represents the last 30 days of real-time data; historical snapshots can also be queried in the `yyyyMM` format, such as `202412` Example: nearly
`page`	`integer`	optional	Page number, starting from 1 Example: 1
`size`	`integer`	optional	Number of items per page, return 10–100 pieces of data Example: 50
`order`	`object`	optional	Sorting configuration, fields are shown in the table below Example: {}
`field`	`string`	required	Sorting fields: `total_units`, `total_amount`, `bsr_rank`, `price`, `rating`, `reviews`, `profit`, `reviews_rate`, `available_date`, `questions`, `total_units_growth`, `total_amount_growth`, `reviews_increasement`, `bsr_rank_cv`, `bsr_rank_cr`, `amz_unit` Example: total_units
`desc`	`string`	required	Sorting direction: `true` descending order, `false` ascending order Example: true

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of matching results Example: {}
`sourceType`	`string`	optional	Source type, such as `amazon` Example: {}
`message`	`string`	optional	Execution message or error description Example: {}
`type`	`string`	optional	rendering style Example: {}
`nodeLabel`	`string`	optional	Category name echo Example: {}
`columns`	`array`	optional	Rendered column definitions Example: {}
`products`	`array`	optional	Competing product list Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`asin`	`string`	optional	Product ASIN Example: {}
`title`	`string`	optional	Product title Example: {}
`price`	`number`	optional	current price Example: {}
`primePrice`	`number`	optional	Prime price Example: {}
`averagePrice`	`number`	optional	average price Example: {}
`currency`	`string`	optional	Currency Example: {}
`monthlySalesUnits`	`integer`	optional	Monthly sales volume (number of pieces) Example: {}
`monthlySalesRevenue`	`number`	optional	monthly sales Example: {}
`monthlySalesUnitsGrowthRate`	`number`	optional	monthly sales growth rate Example: {}
`bsr`	`integer`	optional	BSR Ranking Example: {}
`bsrGrowthRate`	`number`	optional	BSR growth rate Example: {}
`bsrGrowthCount`	`integer`	optional	BSR growth number Example: {}
`rating`	`number`	optional	Rating Example: {}
`ratings`	`integer`	optional	Rating number Example: {}
`ratingsGrowth`	`integer`	optional	Number of new ratings per month Example: {}
`ratingsRate`	`number`	optional	Review rate Example: {}
`brand`	`string`	optional	brand Example: {}
`brandUrl`	`string`	optional	Brand URL Example: {}
`sellerName`	`string`	optional	BuyBox seller name Example: {}
`sellerId`	`string`	optional	BuyBox seller ID Example: {}
`sellerNation`	`string`	optional	BuyBox seller nationality Example: {}
`sellerNum`	`integer`	optional	Number of sellers Example: {}
`fulfillment`	`string`	optional	Delivery method: `AMZ`, `FBA`, `FBM` Example: {}
`availableDate`	`string`	optional	Release time (date format) Example: {}
`availableDateString`	`string`	optional	Release date (string format) Example: {}
`profit`	`number`	optional	Gross profit margin Example: {}
`fba`	`number`	optional	FBA shipping Example: {}
`deliveryPrice`	`number`	optional	Seller shipping fee Example: {}
`imageUrl`	`string`	optional	Product image URL Example: {}
`parent`	`string`	optional	Parent ASIN Example: {}
`variationNum`	`integer`	optional	number of variants Example: {}
`variant30DayUnits`	`integer`	optional	Monthly sales volume of daughter bodies (number of pieces) Example: {}
`variant30DayRevenue`	`number`	optional	Subsidiary monthly sales Example: {}
`variant30DayUpdatedAt`	`string`	optional	Child data update time (timestamp) Example: {}
`amzUnitDateString`	`string`	optional	Sub-body sales update date Example: {}
`listingQualityScore`	`number`	optional	Listing quality score Example: {}
`nodeLabelPath`	`string`	optional	Category path Example: {}
`nodeIdPath`	`string`	optional	Node ID path Example: {}
`nodeId`	`integer`	optional	Node ID Example: {}
`dimension`	`string`	optional	Product size Example: {}
`dimensionsType`	`string`	optional	size type Example: {}
`weight`	`string`	optional	Product weight Example: {}
`packageDimensions`	`string`	optional	Packing size Example: {}
`packageDimensionType`	`string`	optional	Packaging size type Example: {}
`packageWeight`	`string`	optional	Packing weight Example: {}
`sku`	`string`	optional	SKU Example: {}
`keyword`	`string`	optional	matching keywords Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`sourceType`	`string`	optional	Source type Example: {}
`badgeBestSeller`	`string`	optional	Best Seller logo (Y/N) Example: {}
`badgeAmazonChoice`	`string`	optional	Amazon's Choice logo (Y/N) Example: {}
`badgeNewRelease`	`string`	optional	New Release logo (Y/N) Example: {}
`badgeEbc`	`string`	optional	A+ page identification (Y/N) Example: {}
`badgeVideo`	`string`	optional	Video introduction logo (Y/N) Example: {}
`badge`	`object`	optional	Identity details object, including `bestSeller`, `amazonChoice`, `newRelease`, `ebc`, `video` (all Y/N strings) Example: {}
`subcategories`	`array`	optional	Subcategory rankings, each including `code`, `rank`, `label` Example: {}

Examples

Example arguments

{
  "keyword": "wireless earbuds",
  "marketplace": "US",
  "matchType": 1,
  "size": 20
}

Example structuredContent

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