Amazon Public Marketplace Data

Amazon Public Marketplace Data: search API

Amazon Public Marketplace Data: search API.

MCP tool name

nexscope_data_amazon_search

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-amazon-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_amazon_search",
    "arguments": {
      "amazonDomain": "amazon.com",
      "keyword": "wireless earbuds",
      "page": 1
    }
  }
}

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
`keyword`	`string`	optional	Search keywords, it is recommended to use the target site language, the maximum length is 1024. Example: {}
`amazonDomain`	`string`	optional	Amazon site: `amazon.com`, `amazon.co.uk`, `amazon.de`, `amazon.fr`, `amazon.it`, `amazon.es`, `amazon.co.jp`, `amazon.ca`, `amazon.com.au`, `amazon.com.br`, `amazon.in`. `amazon.nl`, `amazon.se`, `amazon.pl`, `amazon.sg`, `amazon.sa`, `amazon.ae`, `amazon.com.mx`, `amazon.com.tr`, `amazon.com.be`, `amazon.cn`, `amazon.eg`. Example: {}
`node`	`string`	optional	Amazon category node, maximum length 1000. Example: {}
`language`	`string`	optional	Locale code, maximum length 1000, for example `en_US`, `de_DE`, `ja_JP`, `fr_FR`. Example: {}
`sort`	`string`	optional	`relevanceblender`, `price-asc-rank`, `price-desc-rank`, `review-rank`, `date-desc-rank` or `exact-aware-popularity-rank`. Example: relevanceblender
`page`	`integer`	optional	Page numbers, starting from 1, approximately 20 entries per page. Example: 1
`deliveryZip`	`string`	optional	Delivery location zip code, used to simulate Amazon front desk address, maximum length 1000. Example: {}
`device`	`string`	optional	Device type: `desktop`, `mobile`, `tablet`, maximum length 1000. Example: desktop

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of rows. Example: {}
`keyword`	`string`	optional	Search keywords. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`columns`	`array`	optional	Rendered column definitions. Example: {}
`costToken`	`integer`	optional	Consume Token. Example: {}
`products`	`array`	optional	List of search results. Example: {}
`asin`	`string`	optional	ASIN。 Example: {}
`title`	`string`	optional	title. Example: {}
`brand`	`string`	optional	brand. Example: {}
`price`	`number`	optional	price. Example: {}
`extractedPrice`	`number`	optional	The parsed price. Example: {}
`oldPrice`	`number`	optional	Underline price. Example: {}
`extractedOldPrice`	`number`	optional	The parsed underlined price. Example: {}
`currency`	`string`	optional	Currency. Example: {}
`priceUnit`	`string`	optional	price unit. Example: {}
`extractedPriceUnit`	`number`	optional	The parsed price unit. Example: {}
`rating`	`number`	optional	Rating. Example: {}
`ratings`	`integer`	optional	Rating number. Example: {}
`position`	`integer`	optional	location. Example: {}
`sponsored`	`boolean`	optional	Sponsor or not. Example: {}
`imageUrl`	`string`	optional	Thumbnail. Example: {}
`asinUrl`	`string`	optional	Product link. Example: {}
`delivery`	`string`	optional	Shipping information. Example: {}
`fulfillment`	`string`	optional	Shipping information, such as FBA. Example: {}
`availableDate`	`string (date)`	optional	Shelf time. Example: {}
`monthlySalesUnits`	`integer`	optional	Monthly sales volume. Example: {}
`monthlySalesRevenue`	`string`	optional	Monthly sales. Example: {}
`sellerNation`	`string`	optional	Seller’s nationality. Example: {}
`dimension`	`string`	optional	size. Example: {}
`weight`	`string`	optional	weight. Example: {}
`options`	`string`	optional	options. Example: {}
`offers`	`string`	optional	Offer information. Example: {}
`badges`	`string`	optional	Amazon front search logo. Example: {}
`tags`	`string`	optional	label. Example: {}
`snapEbtEligible`	`boolean`	optional	SNAP/EBT eligibility. Example: {}
`sourceType`	`string`	optional	Source type: `amazon`. Example: {}
`keyword`	`string`	optional	Keywords. Example: {}

Examples

Example arguments

{
  "amazonDomain": "amazon.com",
  "keyword": "wireless earbuds",
  "page": 1
}

Example structuredContent

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