Amazon Research JS

Amazon Product Database

Find Amazon products by category, price, sales, reviews, and seller type. Call the Amazon Product Database API via REST or MCP from 88 credits per call.

MCP tool name

nexscope_amazon_product_database

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-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_database",
    "arguments": {
      "includeKeywords": "phone case",
      "marketplace": "us",
      "needCount": 10,
      "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 marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp Example: us
`includeKeywords`	`string`	optional	Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case
`excludeKeywords`	`string`	optional	Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case
`categories`	`string`	optional	Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: 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 (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names Example: {}
`minPrice`	`number`	optional	Minimum price Example: 1
`maxPrice`	`number`	optional	Maximum price Example: 1
`minSales`	`integer`	optional	Minimum monthly sales Example: 1
`maxSales`	`integer`	optional	Maximum monthly sales Example: 1
`minRevenue`	`number`	optional	Minimum monthly revenue Example: 1
`maxRevenue`	`number`	optional	Maximum monthly revenue Example: 1
`minReviews`	`integer`	optional	Minimum number of reviews Example: 1
`maxReviews`	`integer`	optional	Maximum number of reviews Example: 1
`minRating`	`number`	optional	Minimum rating (1.0-5.0) Example: 1
`maxRating`	`number`	optional	Maximum rating (1.0-5.0) Example: 1
`minWeight`	`number`	optional	Minimum weight (lbs) Example: 1
`maxWeight`	`number`	optional	Maximum weight (lbs) Example: 1
`minRank`	`integer`	optional	Minimum BSR ranking Example: 1
`maxRank`	`integer`	optional	Maximum BSR ranking Example: 1
`minLqs`	`integer`	optional	Minimum LQS score (1-10) Example: 1
`maxLqs`	`integer`	optional	Maximum LQS score (1-10) Example: 1
`minSellers`	`integer`	optional	Minimum number of sellers Example: 1
`maxSellers`	`integer`	optional	Maximum number of sellers Example: 1
`minNet`	`number`	optional	Minimum net profit Example: 1
`maxNet`	`number`	optional	Maximum net profit Example: 1
`sellerTypes`	`string`	optional	Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm Example: {}
`productTiers`	`string`	optional	Product size tiers, comma-separated. Options: oversize, standard Example: {}
`excludeTopBrands`	`boolean`	optional	Whether to exclude top brands Example: false
`excludeUnavailableProducts`	`boolean`	optional	Whether to exclude unavailable products Example: false
`minUpdatedAt`	`string`	optional	Data update start date (YYYY-MM-DD) Example: 2026-01-01
`maxUpdatedAt`	`string`	optional	Data update end date (YYYY-MM-DD) Example: 2026-01-01
`needCount`	`integer`	optional	Total number of results to return, API auto-paginates internally Example: 1
`sort`	`string`	optional	Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name Example: {}

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": "phone case",
  "marketplace": "us",
  "needCount": 10,
  "sort": "-sales"
}

Example structuredContent

{}