Amazon Marketplace Intelligence

Amazon Product Database Search MCP Tool

Advanced Amazon product search and filtering powered by Keepa data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more.

MCP tool name

nexscope_amazon_product_database_search

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-product-database-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_database_search",
    "arguments": {
      "domain": "1",
      "perPage": 50,
      "page": 1,
      "keyword": "phone case"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-product-database-search

Arguments

Name	Type	Required	Meaning
`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/currentSalesLte`	`integer`	optional	Current sales rank range (lower value = better ranking) Example: 1
`avg90SalesGte/avg90SalesLte`	`integer`	optional	90-day average sales rank range Example: 1
`deltaPercent90SalesGte/deltaPercent90SalesLte`	`integer`	optional	90-day sales rank change percentage range Example: 1
`monthlySoldGte/monthlySoldLte`	`integer`	optional	Units sold / monthly sales range Example: 1
`srAvgGte/srAvgLte`	`integer`	optional	Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) 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/currentNewLte`	`integer`	optional	Current new price range (in minor currency unit) Example: 1
`currentBuyBoxShippingGte/currentBuyBoxShippingLte`	`integer`	optional	Current Buy Box price with shipping range (in minor currency unit) Example: 1
`currentCountReviewsGte/currentCountReviewsLte`	`integer`	optional	Current review count range Example: 1
`currentRatingGte/currentRatingLte`	`number`	optional	Current rating range (0.0-5.0) Example: 1
`packageLengthGte/packageLengthLte`	`integer`	optional	Package length range (mm) Example: 1
`packageWidthGte/packageWidthLte`	`integer`	optional	Package width range (mm) Example: 1
`packageHeightGte/packageHeightLte`	`integer`	optional	Package height range (mm) Example: 1
`packageWeightGte/packageWeightLte`	`integer`	optional	Package weight range (grams) 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/availableDateLte`	`string`	optional	Product listing time range (date format: yyyy-MM-dd) 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/variationCountLte`	`integer`	optional	Variation count range Example: 1
`currentCountNewGte/currentCountNewLte`	`integer`	optional	Current new offer count range Example: 1
`outOfStockPercentage90Gte/outOfStockPercentage90Lte`	`integer`	optional	90-day out-of-stock percentage range 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: []
`history`	`integer`	optional	Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0) Example: 1
`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	Sort (up to 3): array of objects, each containing {"fieldName": "...", "sortDirection": "asc\ Example: []

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.total`	`integer`	optional	Total rows Example: 1
`data.perPage`	`integer`	optional	Items per page Example: 1
`data.currentPage`	`integer`	optional	Current page number Example: 1
`data.totalCount`	`integer`	optional	Total count Example: 1
`data.sourceType`	`string`	optional	Source type: keepa Example: null
`data.type`	`string`	optional	Render style Example: null
`data.columns`	`array`	optional	Rendered columns Example: []
`data.costToken`	`integer`	optional	Token consumption Example: 1
`data.products`	`array`	optional	Product list (see below) Example: []
`data.products[].asin`	`string`	optional	ASIN Example: B072MQ5BRX
`data.products[].title`	`string`	optional	Product title Example: null
`data.products[].brand`	`string`	optional	Brand Example: null
`data.products[].manufacturer`	`string`	optional	Manufacturer Example: null
`data.products[].model`	`string`	optional	Model Example: null
`data.products[].price`	`number`	optional	Current price (in local currency, e.g., USD/EUR) Example: 1
`data.products[].primePrice`	`number`	optional	Prime price Example: 1
`data.products[].currency`	`string`	optional	Currency Example: null
`data.products[].salesRank`	`integer`	optional	Sales rank Example: 1
`data.products[].salesRank30`	`integer`	optional	Average sales rank in last 30 days Example: 1
`data.products[].salesRank90`	`integer`	optional	Average sales rank in last 90 days Example: 1
`data.products[].salesRank180`	`integer`	optional	Average sales rank in last 180 days Example: 1
`data.products[].monthlySalesUnits`	`integer`	optional	Monthly sales units Example: 1
`data.products[].monthlySalesRevenue`	`number`	optional	Monthly sales revenue Example: 1
`data.monthlySalesUnits1MonthAgo..monthlySalesUnits12MonthsAgo`	`integer`	optional	Monthly sales units for each of the last 12 months Example: 1
`data.products[].rating`	`number`	optional	Current rating (0.0-5.0) Example: 1
`data.products[].ratings`	`integer`	optional	Number of ratings Example: 1
`data.products[].reviewCount`	`integer`	optional	Number of reviews Example: 1
`data.products[].availableDate`	`string`	optional	Listing time (yyyy-MM-dd HH:mm:ss) Example: 2026-01-01
`data.products[].lastUpdate`	`string`	optional	Last update time (yyyy-MM-dd HH:mm:ss) Example: 2026-01-01
`data.products[].imageUrl`	`string`	optional	Image URL (request address) Example: https://example.com/image.jpg
`data.products[].productImageUrls`	`array`	optional	Product image list Example: []
`data.products[].asinUrl`	`string`	optional	Amazon ASIN detail page URL Example: B072MQ5BRX
`data.products[].categoryTree`	`string`	optional	Category tree Example: null
`data.products[].categoryTreeId`	`string`	optional	Category tree ID Example: example-id
`data.products[].rootCategory`	`integer`	optional	Root category ID Example: 1
`data.products[].subcategories`	`array`	optional	Subcategory list, containing code (category ID), rank (ranking), label (category name) Example: []
`data.products[].fulfillment`	`string`	optional	Fulfillment method (AMZ, FBA, FBM) Example: null
`data.products[].buyBoxSellerId`	`string`	optional	Buy Box seller ID Example: example-id
`data.products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`data.products[].parentAsin`	`string`	optional	Parent ASIN Example: B072MQ5BRX
`data.products[].variationNum`	`integer`	optional	Number of variations Example: 1
`data.products[].color`	`string`	optional	Color Example: null
`data.products[].dimension`	`string`	optional	Dimensions Example: null
`data.products[].dimensionsType`	`string`	optional	Dimensions type Example: null
`data.products[].material`	`string`	optional	Product material, the primary material used in its construction Example: null
`data.products[].weight`	`string`	optional	Weight (grams) Example: null
`data.products[].packageWeight`	`string`	optional	Package weight (grams) Example: null
`data.products[].packageLength`	`integer`	optional	Package length (mm) Example: 1
`data.products[].packageWidth`	`integer`	optional	Package width (mm) Example: 1
`data.products[].packageHeight`	`integer`	optional	Package height (mm) Example: 1
`data.products[].packageDimensions`	`string`	optional	Package dimensions Example: null
`data.products[].packageQuantity`	`integer`	optional	Quantity of items in the package, 0 or -1 if unavailable Example: 1
`data.products[].itemLength`	`integer`	optional	Item length (mm), 0 or -1 if unavailable Example: 1
`data.products[].itemWidth`	`integer`	optional	Item width (mm), 0 or -1 if unavailable Example: 1
`data.products[].itemHeight`	`integer`	optional	Item height (mm), 0 or -1 if unavailable Example: 1
`data.products[].isAdultProduct`	`boolean`	optional	Whether it is an adult product Example: false
`data.products[].isHazmat`	`boolean`	optional	Whether it is hazardous material Example: false
`data.products[].referralFeePercentage`	`number`	optional	Referral fee percentage Example: 1
`data.products[].fbaFees`	`number`	optional	FBA fulfillment fee (in local currency) Example: 1
`data.products[].profit`	`number`	optional	Profit margin (percentage, e.g., 25.5 means 25.5%) Example: 1
`data.products[].urlSlug`	`string`	optional	URL slug Example: https://example.com/image.jpg
`data.products[].sourceType`	`string`	optional	Source type: keepa Example: null
`data.products[].sourceTool`	`string`	optional	Source tool Example: null
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "total": 1,
    "perPage": 1,
    "currentPage": 1,
    "totalCount": 1,
    "columns": [],
    "costToken": 1,
    "products": [
      {
        "asin": "B072MQ5BRX",
        "price": 1,
        "primePrice": 1,
        "salesRank": 1,
        "salesRank30": 1,
        "salesRank90": 1,
        "salesRank180": 1,
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "rating": 1,
        "ratings": 1,
        "reviewCount": 1,
        "availableDate": "2026-01-01",
        "lastUpdate": "2026-01-01",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "asinUrl": "B072MQ5BRX",
        "categoryTreeId": "example-id",
        "rootCategory": 1,
        "subcategories": [],
        "buyBoxSellerId": "example-id",
        "sellerNum": 1,
        "parentAsin": "B072MQ5BRX",
        "variationNum": 1,
        "packageLength": 1,
        "packageWidth": 1,
        "packageHeight": 1,
        "packageQuantity": 1,
        "itemLength": 1,
        "itemWidth": 1,
        "itemHeight": 1,
        "isAdultProduct": false,
        "isHazmat": false,
        "referralFeePercentage": 1,
        "fbaFees": 1,
        "profit": 1,
        "urlSlug": "https://example.com/image.jpg"
      }
    ],
    "monthlySalesUnits1MonthAgo": {
      "": {
        "monthlySalesUnits12MonthsAgo": 1
      }
    }
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}