Amazon Research JS

Amazon Research JS: product database/query API

Amazon Research JS: product database/query API.

MCP tool name

nexscope_data_js_product_database_query

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-js-product-database-query-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_js_product_database_query",
    "arguments": {
      "includeKeywords": "yoga mat",
      "marketplace": "us",
      "maxPrice": 50,
      "minRating": 4,
      "minSales": 300,
      "needCount": 20,
      "sort": "-sales"
    }
  }
}

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`	required	Target market code. Optional values: `us`, `uk`, `de`, `in`, `ca`, `fr`, `it`, `es`, `mx`, `jp` Example: us
`includeKeywords`	`string`	optional	Title/ASIN contains keywords, comma separated, up to 100 items, each item can be up to 50 characters Example: {}
`excludeKeywords`	`string`	optional	Title/ASIN excluded keywords, comma separated, up to 100 items, each item can be up to 50 characters Example: {}
`categories`	`string`	optional	Main category names, separated by commas, must match the standard category names of the corresponding site. Examples of US sites: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc.; other sites have corresponding local category names Example: {}
`minPrice`	`number`	optional	lowest price Example: {}
`maxPrice`	`number`	optional	highest price Example: {}
`minSales`	`integer`	optional	Minimum monthly sales Example: {}
`maxSales`	`integer`	optional	Highest monthly sales Example: {}
`minRevenue`	`number`	optional	minimum monthly income Example: {}
`maxRevenue`	`number`	optional	highest monthly income Example: {}
`minReviews`	`integer`	optional	Minimum number of comments Example: {}
`maxReviews`	`integer`	optional	Highest number of comments Example: {}
`minRating`	`number`	optional	Lowest rating (1.0-5.0) Example: {}
`maxRating`	`number`	optional	Highest rating (1.0-5.0) Example: {}
`minWeight`	`number`	optional	Minimum weight (lbs) Example: {}
`maxWeight`	`number`	optional	Maximum weight (lbs) Example: {}
`minRank`	`integer`	optional	Lowest BSR Rank Example: {}
`maxRank`	`integer`	optional	Highest BSR Rank Example: {}
`minLqs`	`integer`	optional	Minimum LQS score (1-10) Example: {}
`maxLqs`	`integer`	optional	Highest LQS score (1-10) Example: {}
`minSellers`	`integer`	optional	Minimum number of sellers Example: {}
`maxSellers`	`integer`	optional	Maximum number of sellers Example: {}
`minNet`	`number`	optional	minimum net profit Example: {}
`maxNet`	`number`	optional	highest net profit Example: {}
`sellerTypes`	`string`	optional	Seller types, separated by commas. Optional values: `amz` (Amazon self-operated), `fba`, `fbm` Example: {}
`productTiers`	`string`	optional	Product size hierarchy, separated by commas. Optional values: `oversize`, `standard` Example: {}
`excludeTopBrands`	`boolean`	optional	Whether to exclude top brands Example: {}
`excludeUnavailableProducts`	`boolean`	optional	Whether to exclude unpurchasable items Example: {}
`minUpdatedAt`	`string`	optional	Data update start date (YYYY-MM-DD) Example: {}
`maxUpdatedAt`	`string`	optional	Data update deadline (YYYY-MM-DD) Example: {}
`needCount`	`integer`	optional	The total number of results to be returned, automatic paging within the API Example: {}
`sort`	`string`	optional	Sort field. Available options `name` `-name` `category` `-category` `revenue` `-revenue` `sales` `-sales` `price` `-price` `rank` `-rank` `reviews` `-reviews` `lqs` `-lqs` `sellers` `-sellers` `-`. A leading `-` sorts in descending order Example: name

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`costToken`	`integer`	optional	Number of tokens consumed Example: {}
`productDatabaseList`	`array`	optional	Product data list Example: {}
`id`	`string`	optional	Product unique identifier Example: {}
`title`	`string`	optional	product title Example: {}
`brand`	`string`	optional	brand name Example: {}
`category`	`string`	optional	Main category Example: {}
`breadcrumbPath`	`string`	optional	Full classification path Example: {}
`price`	`number`	optional	Current selling price (USD) Example: {}
`approximate30DayUnitsSold`	`integer`	optional	Estimated sales in the past 30 days Example: {}
`approximate30DayRevenue`	`number`	optional	Estimated revenue for the last 30 days (USD) Example: {}
`productRank`	`integer`	optional	BSR Ranking Example: {}
`reviews`	`integer`	optional	Total number of comments Example: {}
`rating`	`number`	optional	Average rating (1.0-5.0) Example: {}
`listingQualityScore`	`integer`	optional	Listing Quality Score (LQS, 1-10) Example: {}
`numberOfSellers`	`integer`	optional	Number of sellers on sale Example: {}
`sellerType`	`string`	optional	Seller type (amz/fba/fbm) Example: {}
`imageUrl`	`string`	optional	Product main image URL Example: {}
`dateFirstAvailable`	`string`	optional	Date first put on shelves Example: {}
`weightValue`	`number`	optional	Product weight Example: {}
`weightUnit`	`string`	optional	weight unit Example: {}
`lengthValue`	`number`	optional	length Example: {}
`widthValue`	`number`	optional	Width Example: {}
`heightValue`	`number`	optional	height Example: {}
`dimensionsUnit`	`string`	optional	Dimensional unit Example: {}
`parentAsin`	`string`	optional	Parent ASIN Example: {}
`isParent`	`boolean`	optional	Is it the parent body? Example: {}
`isVariant`	`boolean`	optional	Is it a variant? Example: {}
`isStandalone`	`boolean`	optional	Is it an independent product? Example: {}
`isAvailable`	`boolean`	optional	available for purchase Example: {}
`buyBoxOwner`	`string`	optional	Buy Box holds seller name Example: {}
`buyBoxOwnerSellerId`	`string`	optional	Buy Box holds seller ID Example: {}
`updatedAt`	`string`	optional	Data update time Example: {}
`feeBreakdown`	`object`	optional	Fee details: `fbaFee` (FBA fee), `referralFee` (referral fee), `variableClosingFee` (variable settlement fee), `totalFees` (total fee) Example: {}
`subcategoryRanks`	`array`	optional	Subcategory BSR ranking list, each containing `subcategory`, `rank`, `id` Example: {}
`type`	`string`	optional	Resource type Example: {}
`variants`	`array`	optional	Variation list Example: {}
`upcList`	`array`	optional	UPC code list Example: {}
`eanList`	`array`	optional	EAN code list Example: {}
`isbnList`	`array`	optional	ISBN code list Example: {}
`gtinList`	`array`	optional	GTIN code list Example: {}
`dateFirstAvailableIsEstimated`	`boolean`	optional	Is the release date an estimate? Example: {}

Examples

Example arguments

{
  "includeKeywords": "yoga mat",
  "marketplace": "us",
  "maxPrice": 50,
  "minRating": 4,
  "minSales": 300,
  "needCount": 20,
  "sort": "-sales"
}

Example structuredContent

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