Amazon Marketplace Intelligence

Amazon Market Research

Use Nexscope market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions. Trigger when the user mentions Amazon market research, niche category research, market opportunity screening, market concentration analysis, new product opportunities, market selection, Nexscope market research, category market research. Even if the user does not explicitly mention "Nexscope", if the need is to screen and evaluate Amazon markets by category dimensions, this skill should also be triggered.

post/api/skill-api/v1/skills/amazon-market-research/run

Request

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

Site code, see marketplace

nodeIdPathstring

Category node ID path, e.g. 172282:281407

departmentKeywordstring

Category keyword path, e.g. Electronics:Accessories & Supplies

sellerLocationstring

Seller location, multiple values comma-separated; see Nexscope table 1.3 for values

newProductinteger

New product definition (months)

topNuminteger

Top Listing count

monthstring

Filter date: nearly or yyyyMM

pageinteger

Page number, starting from 1

sizeinteger

Results per page

orderFieldstring

Sort field, see orderField

orderDescboolean

true descending, false ascending

minAvgRevenue/maxAvgRevenuenumber

Minimum / maximum average monthly sales revenue

minAvgUnits/maxAvgUnitsinteger

Minimum / maximum average monthly sales volume

minGoodsCount/maxGoodsCountinteger

Minimum / maximum product count

minSellers/maxSellersinteger

Minimum / maximum seller count

minBrands/maxBrandsinteger

Minimum / maximum brand count

minAvgSellers/maxAvgSellersnumber

Minimum / maximum average seller count

minGoodsCrn/maxGoodsCrnnumber

Minimum / maximum product concentration (decimal 0-1)

minSellerCrn/maxSellerCrnnumber

Minimum / maximum seller concentration (decimal 0-1)

minBrandCrn/maxBrandCrnnumber

Minimum / maximum brand concentration (decimal 0-1)

minAmazonSelfProportion/maxAmazonSelfProportionnumber

Minimum / maximum Amazon self-operated share (decimal 0-1)

minFbaProportion/maxFbaProportionnumber

Minimum / maximum FBA share (decimal 0-1)

minFbmProportion/maxFbmProportionnumber

Minimum / maximum FBM share (decimal 0-1)

minEbcProportion/maxEbcProportionnumber

Minimum / maximum A+ share (decimal 0-1)

minNewProportion/maxNewProportionnumber

Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior)

minAvgPrice/maxAvgPricenumber

Minimum / maximum average price

minAvgRating/maxAvgRatingnumber

Minimum / maximum average rating value

minAvgRatings/maxAvgRatingsinteger

Minimum / maximum average review count

minAvgProfit/maxAvgProfitnumber

Minimum / maximum average gross margin (input N means N%, 0-100)

minAvgBsr/maxAvgBsrinteger

Minimum / maximum average BSR rank

minNewCount/maxNewCountinteger

Minimum / maximum new product count

minNewAvgPrice/maxNewAvgPricenumber

Minimum / maximum new product average price

minNewAvgRating/maxNewAvgRatingnumber

Minimum / maximum new product average star rating

minNewAvgRatings/maxNewAvgRatingsinteger

Minimum / maximum new product average review count

minNewAvgUnits/maxNewAvgUnitsnumber

Minimum / maximum new product average monthly sales

minNewAvgRevenue/maxNewAvgRevenuenumber

Minimum / maximum new product average monthly revenue

minTopAvgUnits/maxTopAvgUnitsinteger

Minimum / maximum top listing average monthly sales

minTopAvgRevenue/maxTopAvgRevenuenumber

Minimum / maximum top listing average monthly revenue

minTopAvgBsr/maxTopAvgBsrinteger

Minimum / maximum top listing average BSR

minWeight/maxWeightnumber

Minimum / maximum weight

minVolume/maxVolumenumber

Minimum / maximum volume

Example request

{
  "page": 1,
  "topNum": 1,
  "marketplace": "US",
  "size": 1,
  "newProduct": 1,
  "departmentKeyword": "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,
    "marketplace": "US",
    "data": [],
    "costToken": 1
  }
}

Changes

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