Amazon Marketplace Intelligence

Amazon Product Database Search

Advanced Amazon product search and filtering powered by Nexscope data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more. Trigger when users mention Nexscope product selection, Amazon product search, advanced product selection, BSR filtering, sales rank filtering, keyword-based product discovery, category search, competitor screening, niche product discovery, historical rank filtering, or similar terms. Even if the user does not explicitly mention "Nexscope," trigger this skill whenever the request involves multi-criteria Amazon product search, sales-metric-based filtering, or advanced product selection beyond simple keyword search.

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

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-database-search/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

domainstring 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

keywordstring

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)

currentSalesGte/currentSalesLteinteger

Current sales rank range (lower value = better ranking)

avg90SalesGte/avg90SalesLteinteger

90-day average sales rank range

deltaPercent90SalesGte/deltaPercent90SalesLteinteger

90-day sales rank change percentage range

monthlySoldGte/monthlySoldLteinteger

Units sold / monthly sales range

srAvgGte/srAvgLteinteger

Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth)

srAvgMonthstring

Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months)

currentNewGte/currentNewLteinteger

Current new price range (in minor currency unit)

currentBuyBoxShippingGte/currentBuyBoxShippingLteinteger

Current Buy Box price with shipping range (in minor currency unit)

currentCountReviewsGte/currentCountReviewsLteinteger

Current review count range

currentRatingGte/currentRatingLtenumber

Current rating range (0.0-5.0)

packageLengthGte/packageLengthLteinteger

Package length range (mm)

packageWidthGte/packageWidthLteinteger

Package width range (mm)

packageHeightGte/packageHeightLteinteger

Package height range (mm)

packageWeightGte/packageWeightLteinteger

Package weight range (grams)

availableDateGte/availableDateLtestring

Product listing time range (date format: yyyy-MM-dd)

buyBoxIsAmazonboolean

Whether the Buy Box seller is Amazon

buyBoxIsFBAboolean

Whether the Buy Box is FBA

isHazMatboolean

Whether it is hazardous material

variationCountGte/variationCountLteinteger

Variation count range

currentCountNewGte/currentCountNewLteinteger

Current new offer count range

outOfStockPercentage90Gte/outOfStockPercentage90Lteinteger

90-day out-of-stock percentage range

singleVariationboolean

Return only one variation; when set to true, multi-variation products will only return one variation

historyinteger

Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0)

ratinginteger

Whether to fetch rating info (1=fetch, 0=do not fetch, default 1)

pageinteger

Page number (starting from 1, default 1)

perPageinteger

Maximum results per page (min 50, max 100, default 50)

Example request

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

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": {
    "total": 1,
    "perPage": 1,
    "currentPage": 1,
    "totalCount": 1,
    "costToken": 1,
    "products": []
  }
}

Changes

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