Amazon Marketplace Intelligence

Amazon Product Database

Nexscope Product Database multi-condition filtering. Filter Amazon products by category, price, sales volume, revenue, reviews, rating, weight, BSR rank, LQS, seller type, and more across 10 marketplaces. Trigger when users mention Amazon product selection, product database filtering, BSR rank filtering, category-based product discovery, high-rating low-competition products, FBA product search, Amazon product discovery, or similar terms. Even if the user does not explicitly mention "Nexscope" or "product database," trigger this skill whenever the request involves filtering Amazon products by multiple criteria or discovering potential products.

post/api/skill-api/v1/skills/amazon-product-database/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-database/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

marketplacestring required

Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp

includeKeywordsstring

Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each

excludeKeywordsstring

Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each

categoriesstring

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

minPricenumber

Minimum price

maxPricenumber

Maximum price

minSalesinteger

Minimum monthly sales

maxSalesinteger

Maximum monthly sales

minRevenuenumber

Minimum monthly revenue

maxRevenuenumber

Maximum monthly revenue

minReviewsinteger

Minimum number of reviews

maxReviewsinteger

Maximum number of reviews

minRatingnumber

Minimum rating (1.0-5.0)

maxRatingnumber

Maximum rating (1.0-5.0)

minWeightnumber

Minimum weight (lbs)

maxWeightnumber

Maximum weight (lbs)

minRankinteger

Minimum BSR ranking

maxRankinteger

Maximum BSR ranking

minLqsinteger

Minimum LQS score (1-10)

maxLqsinteger

Maximum LQS score (1-10)

minSellersinteger

Minimum number of sellers

maxSellersinteger

Maximum number of sellers

minNetnumber

Minimum net profit

maxNetnumber

Maximum net profit

sellerTypesstring

Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm

productTiersstring

Product size tiers, comma-separated. Options: oversize, standard

excludeTopBrandsboolean

Whether to exclude top brands

excludeUnavailableProductsboolean

Whether to exclude unavailable products

minUpdatedAtstring

Data update start date (YYYY-MM-DD)

maxUpdatedAtstring

Data update end date (YYYY-MM-DD)

needCountinteger

Total number of results to return, API auto-paginates internally

sortstring

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 request

{
  "sort": "-sales",
  "marketplace": "us",
  "includeKeywords": "phone case",
  "needCount": 10
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "costToken": 1,
    "productDatabaseList": []
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.