Amazon History KP

Amazon Product Database Search

Find Amazon products using detailed price, sales, size, and shipping filters. Call via REST API or MCP from 13 credits per call.

MCP tool name

nexscope_amazon_product_database_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": "amazon-product-database-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_database_search",
    "arguments": {
      "domain": "1",
      "keyword": "phone case",
      "page": 1,
      "perPage": 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
`domain`	`string`	required	Amazon domain ID: 1=United States, 2=United Kingdom, 3=Germany, 4=France, 5=Japan, 6=Canada, 8=Italy, 9=Spain, 10=India, 11=Mexico Example: 1
`keyword`	`string`	optional	Title keyword (case-insensitive; spaces mean AND tokenization; wrap keywords containing spaces in double quotes; prefix - for exclusion; & symbol is replaced with space; up to 50 keywords, max 1000 characters) Example: phone case
`rootCategory`	`array`	optional	Root category IDs (up to 50), only include products in these root categories Example: []
`rootCategoryNames`	`array`	optional	Root category names (up to 50), used when rootCategory is empty; the system automatically looks up corresponding category IDs Example: []
`categoriesInclude`	`array`	optional	Subcategory IDs to include only (up to 50), only include products directly listed in these subcategories Example: []
`categoriesIncludeNames`	`array`	optional	Subcategory names to include (up to 50), used when categoriesInclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths (separated by : or >) for more accurate results Example: []
`categoriesExclude`	`array`	optional	Subcategory IDs to exclude (up to 50) Example: []
`categoriesExcludeNames`	`array`	optional	Subcategory names to exclude (up to 50), used when categoriesExclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths for more accurate results Example: []
`currentSalesGte`	`integer`	optional	Current sales rank range (lower value = better ranking) (lower bound) Example: 1
`currentSalesLte`	`integer`	optional	Current sales rank range (lower value = better ranking) (upper bound) Example: 1
`avg90SalesGte`	`integer`	optional	90-day average sales rank range (lower bound) Example: 1
`avg90SalesLte`	`integer`	optional	90-day average sales rank range (upper bound) Example: 1
`deltaPercent90SalesGte`	`integer`	optional	90-day sales rank change percentage range (lower bound) Example: 1
`deltaPercent90SalesLte`	`integer`	optional	90-day sales rank change percentage range (upper bound) Example: 1
`monthlySoldGte`	`integer`	optional	Units sold / monthly sales range (lower bound) Example: 1
`monthlySoldLte`	`integer`	optional	Units sold / monthly sales range (upper bound) Example: 1
`srAvgGte`	`integer`	optional	Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) (lower bound) Example: 1
`srAvgLte`	`integer`	optional	Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) (upper bound) Example: 1
`srAvgMonth`	`string`	optional	Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months) Example: {}
`currentNewGte`	`integer`	optional	Current new price range (in minor currency unit) (lower bound) Example: 1
`currentNewLte`	`integer`	optional	Current new price range (in minor currency unit) (upper bound) Example: 1
`currentBuyBoxShippingGte`	`integer`	optional	Current Buy Box price with shipping range (in minor currency unit) (lower bound) Example: 1
`currentBuyBoxShippingLte`	`integer`	optional	Current Buy Box price with shipping range (in minor currency unit) (upper bound) Example: 1
`currentCountReviewsGte`	`integer`	optional	Current review count range (lower bound) Example: 1
`currentCountReviewsLte`	`integer`	optional	Current review count range (upper bound) Example: 1
`currentRatingGte`	`number`	optional	Current rating range (0.0-5.0) (lower bound) Example: 1
`currentRatingLte`	`number`	optional	Current rating range (0.0-5.0) (upper bound) Example: 1
`packageLengthGte`	`integer`	optional	Package length range (mm) (lower bound) Example: 1
`packageLengthLte`	`integer`	optional	Package length range (mm) (upper bound) Example: 1
`packageWidthGte`	`integer`	optional	Package width range (mm) (lower bound) Example: 1
`packageWidthLte`	`integer`	optional	Package width range (mm) (upper bound) Example: 1
`packageHeightGte`	`integer`	optional	Package height range (mm) (lower bound) Example: 1
`packageHeightLte`	`integer`	optional	Package height range (mm) (upper bound) Example: 1
`packageWeightGte`	`integer`	optional	Package weight range (grams) (lower bound) Example: 1
`packageWeightLte`	`integer`	optional	Package weight range (grams) (upper bound) Example: 1
`brand`	`array`	optional	Brand (OR match) Example: []
`color`	`array`	optional	Color (OR match), filter products with specified colors Example: []
`size`	`array`	optional	Size (OR match), filter products with specified sizes Example: []
`availableDateGte`	`string`	optional	Product listing time range (date format: yyyy-MM-dd) (lower bound) Example: 2026-01-01
`availableDateLte`	`string`	optional	Product listing time range (date format: yyyy-MM-dd) (upper bound) Example: 2026-01-01
`buyBoxIsAmazon`	`boolean`	optional	Whether the Buy Box seller is Amazon Example: false
`buyBoxIsFBA`	`boolean`	optional	Whether the Buy Box is FBA Example: false
`isHazMat`	`boolean`	optional	Whether it is hazardous material Example: false
`variationCountGte`	`integer`	optional	Variation count range (lower bound) Example: 1
`variationCountLte`	`integer`	optional	Variation count range (upper bound) Example: 1
`currentCountNewGte`	`integer`	optional	Current new offer count range (lower bound) Example: 1
`currentCountNewLte`	`integer`	optional	Current new offer count range (upper bound) Example: 1
`outOfStockPercentage90Gte`	`integer`	optional	90-day out-of-stock percentage range (lower bound) Example: 1
`outOfStockPercentage90Lte`	`integer`	optional	90-day out-of-stock percentage range (upper bound) Example: 1
`singleVariation`	`boolean`	optional	Return only one variation; when set to true, multi-variation products will only return one variation Example: false
`productType`	`array`	optional	Product type filter (default [0,1,2]): 0=standard product, 1=downloadable product, 2=eBook, 5=variant parent ASIN Example: [ 0, 1, 2 ]
`history`	`integer`	optional	Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0) Example: 0
`rating`	`integer`	optional	Whether to fetch rating info (1=fetch, 0=do not fetch, default 1) Example: 1
`page`	`integer`	optional	Page number (starting from 1, default 1) Example: 1
`perPage`	`integer`	optional	Maximum results per page (min 50, max 100, default 50) Example: 50
`sort`	`array`	optional	Up to 3 sort rules, each with fieldName and sortDirection (asc or desc); supported fields: availableDate, currentSales, monthlySold, currentRating, currentCountReviews, currentBuyBoxShipping, currentNew Example: []

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of rows. Example: {}
`perPage`	`integer`	optional	Quantity per page. Example: {}
`currentPage`	`integer`	optional	Current page number. Example: {}
`totalCount`	`integer`	optional	Total quantity. Example: {}
`sourceType`	`string`	optional	Source type: `kp`. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`columns`	`array`	optional	Rendered columns. Example: {}
`costToken`	`integer`	optional	Consume token. Example: {}
`products`	`array`	optional	Product list, element fields are shown in the table below. Example: {}
`asin`	`string`	optional	ASIN。 Example: {}
`title`	`string`	optional	Product title. Example: {}
`brand`	`string`	optional	brand. Example: {}
`manufacturer`	`string`	optional	manufacturer. Example: {}
`model`	`string`	optional	model. Example: {}
`price`	`number`	optional	Current price in local currency. Example: {}
`primePrice`	`number`	optional	Prime Price. Example: {}
`currency`	`string`	optional	Currency. Example: {}
`salesRank`	`integer`	optional	Sales ranking. Example: {}
`salesRank30`	`integer`	optional	Average sales rank over the past 30 days. Example: {}
`salesRank90`	`integer`	optional	Average sales rank over the last 90 days. Example: {}
`salesRank180`	`integer`	optional	Average sales rank over the last 180 days. Example: {}
`monthlySalesUnits`	`integer`	optional	Monthly sales volume. Example: {}
`monthlySalesRevenue`	`number`	optional	Monthly sales. Example: {}
`rating`	`number`	optional	Current rating (0.0-5.0). Example: {}
`ratings`	`integer`	optional	Number of ratings. Example: {}
`reviewCount`	`integer`	optional	Number of comments. Example: {}
`availableDate`	`string`	optional	Shelf time (`yyyy-MM-dd HH:mm:ss`). Example: {}
`lastUpdate`	`string`	optional	Last updated time (`yyyy-MM-dd HH:mm:ss`). Example: {}
`imageUrl`	`string`	optional	Image URL (request address). Example: {}
`productImageUrls`	`array`	optional	List of product images. Example: {}
`asinUrl`	`string`	optional	Amazon ASIN details URL. Example: {}
`categoryTree`	`string`	optional	Category tree. Example: {}
`categoryTreeId`	`string`	optional	Category tree ID. Example: {}
`rootCategory`	`integer`	optional	Root category ID. Example: {}
`subcategories`	`array`	optional	Subcategory list, including `code` (category ID), `rank` (ranking), `label` (category name). Example: {}
`fulfillment`	`string`	optional	Delivery method: `AMZ`, `FBA`, `FBM`. Example: {}
`buyBoxSellerId`	`string`	optional	Buy button seller ID. Example: {}
`sellerNum`	`integer`	optional	Number of sellers. Example: {}
`parentAsin`	`string`	optional	Parent ASIN. Example: {}
`variationNum`	`integer`	optional	Number of variants. Example: {}
`color`	`string`	optional	color. Example: {}
`dimension`	`string`	optional	size. Example: {}
`dimensionsType`	`string`	optional	Size type. Example: {}
`material`	`string`	optional	The material of a product refers to the main materials used in its construction. Example: {}
`weight`	`string`	optional	Weight (grams). Example: {}
`packageWeight`	`string`	optional	Packing weight (grams). Example: {}
`packageLength`	`integer`	optional	Package length (mm). Example: {}
`packageWidth`	`integer`	optional	Package width (mm). Example: {}
`packageHeight`	`integer`	optional	Package height (mm). Example: {}
`packageDimensions`	`string`	optional	Packaging size. Example: {}
`packageQuantity`	`integer`	optional	The quantity of the item in the package, or 0 or -1 if not available. Example: {}
`itemLength`	`integer`	optional	Product length in millimeters, 0 or -1 if not available. Example: {}
`itemWidth`	`integer`	optional	Product width (mm), 0 or -1 if not available. Example: {}
`itemHeight`	`integer`	optional	Product height in millimeters, 0 or -1 if not available. Example: {}
`isAdultProduct`	`boolean`	optional	Whether it is an adult product. Example: {}
`isHazmat`	`boolean`	optional	Whether it is dangerous goods. Example: {}
`referralFeePercentage`	`number`	optional	Referral fee percentage. Example: {}
`fbaFees`	`number`	optional	FBA fulfillment fee in local currency. Example: {}
`profit`	`number`	optional	Profit margin (percentage, such as 25.5 for 25.5%). Example: {}
`urlSlug`	`string`	optional	URL Slug。 Example: {}
`sourceType`	`string`	optional	Source type: `kp`. Example: {}
`code`	`—`	optional	Category ID; element type shall be subject to the source file or upstream official documentation. Example: {}
`rank`	`—`	optional	Ranking; element type shall be based on the source file or upstream official documentation. Example: {}
`label`	`—`	optional	Category name; element type shall be subject to the source file or upstream official documentation. Example: {}

Examples

Example arguments

{
  "domain": "1",
  "keyword": "phone case",
  "page": 1,
  "perPage": 50
}

Example structuredContent

{}