Amazon

Amazon Product Database Search

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

MCP endpoint

https://api.nexscope.ai/api/skill-api/v2/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.

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

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then 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": {
      "keyword": "phone case",
      "page": 1,
      "perPage": 50,
      "domain": "1"
    }
  }
}

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

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

Progress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it 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
`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

Examples

Example arguments

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

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,
        "monthlySalesUnits1MonthAgo": 1,
        "monthlySalesUnits2MonthsAgo": 1,
        "monthlySalesUnits3MonthsAgo": 1,
        "monthlySalesUnits4MonthsAgo": 1,
        "monthlySalesUnits5MonthsAgo": 1,
        "monthlySalesUnits6MonthsAgo": 1,
        "monthlySalesUnits7MonthsAgo": 1,
        "monthlySalesUnits8MonthsAgo": 1,
        "monthlySalesUnits9MonthsAgo": 1,
        "monthlySalesUnits10MonthsAgo": 1,
        "monthlySalesUnits11MonthsAgo": 1,
        "monthlySalesUnits12MonthsAgo": 1,
        "rating": 1,
        "ratings": 1,
        "reviewCount": 1,
        "availableDate": "2026-01-01 00:00:00",
        "lastUpdate": "2026-01-01 00:00:00",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "asinUrl": "https://www.amazon.com/dp/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": "example-product"
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Amazon Product Database Search

Amazon Product Database Search

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 2