Amazon Intelligence SS

Amazon Competitor Lookup

Compare competing Amazon products by sales, price, and growth. Call the Amazon Competitor Lookup API via REST or MCP from 21 credits per call.

MCP tool name

nexscope_amazon_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": "amazon-competitor-lookup-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_competitor_lookup",
    "arguments": {
      "asinList": "B072MQ5BRX",
      "keyword": "phone case",
      "marketplace": "US",
      "matchType": 1,
      "page": 1,
      "size": 50
    }
  }
}

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 code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN Example: US
`keyword`	`string`	optional	Search keyword. Translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc. Example: phone case
`asinList`	`string`	optional	ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$ Example: B072MQ5BRX
`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, levels separated by colon :, e.g. Electronics:Headphones Example: {}
`nodeIdPath`	`string`	optional	Amazon category ID path Example: {}
`matchType`	`integer`	optional	Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match Example: 1
`showVariation`	`string`	optional	Whether to query variants. Y = yes, N = no (default) Example: {}
`dataSnapshotMonth`	`string`	optional	Amazon product data snapshot month. Default nearly (queries last 30 days real-time data). Use yyyyMM format to query historical snapshots (e.g. 202412 for December 2024). Only supports existing historical snapshots, future dates are not supported. Recommended for seasonal analysis to query the same period last year's snapshot for comparison Example: {}
`page`	`integer`	optional	Page number, starting from 1 (default 1) Example: 1
`size`	`integer`	optional	Results per page, returns 10-100 records (default 50) Example: 50
`order`	`object`	optional	Sort configuration (see below) Example: {}
`order.field`	`string`	optional	Sort field; required when order is supplied Example: total_units
`order.desc`	`string`	optional	Sort direction true/false; required when order is supplied 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

{
  "asinList": "B072MQ5BRX",
  "keyword": "phone case",
  "marketplace": "US",
  "matchType": 1,
  "page": 1,
  "size": 50
}

Example structuredContent

{}