Amazon Marketplace Intelligence

Amazon Broad Product Search

Use Nexscope data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces. Trigger when the user mentions Amazon product selection research, product filtering, sales filtering, product discovery, BSR analysis, niche product discovery, competitor analysis, market opportunity assessment, product-level market size estimation, gross margin screening, Nexscope product selection, Amazon product selection, sales filtering, BSR analysis, profit screening, market analysis, product selection tool. Even if the user does not explicitly mention "Nexscope", if their need involves filtering and analyzing Amazon product-level data for product selection, this skill should also be triggered.

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

Request

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

chatIdstring

Chat ID, maxLength 1000

uidstring

User ID, maxLength 1000

requestIdstring

Push ID, maxLength 1000

teamIdstring

Team ID, maxLength 1000

keywordstring

Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240

matchTypeinteger

Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match

excludeKeywordsstring

Exclude keywords; maxLength 10240

marketplacestring

Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported)

nodeLabelstring

Amazon category name; maxLength 1000

nodeIdPathstring

Amazon category node ID; maxLength 1000

filterSubNodeboolean

Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false

dataSnapshotMonthstring

Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000

minPricenumber

Minimum price (>= 0)

maxPricenumber

Maximum price (>= 0)

minProfitnumber

Minimum gross margin, unit % (1-100)

maxProfitnumber

Maximum gross margin, unit % (1-100)

minRevenuenumber

Minimum monthly sales revenue (>= 0)

maxRevenuenumber

Maximum monthly sales revenue (>= 0)

minFbanumber

Minimum FBA shipping fee (>= 0)

maxFbanumber

Maximum FBA shipping fee (>= 0)

minUnitsinteger

Minimum monthly sales volume (>= 0)

maxUnitsinteger

Maximum monthly sales volume (>= 0)

minAmzUnitinteger

Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a "last 30 days" type query); minimum 0

maxAmzUnitinteger

Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0

minUnitsGrowthRatenumber

Minimum monthly sales volume growth rate, unit %

maxUnitsGrowthRatenumber

Maximum monthly sales volume growth rate, unit %

minBsrinteger

Lowest main category BSR rank

maxBsrinteger

Highest main category BSR rank

minBsrGrowthRatenumber

Minimum BSR growth rate, unit %

maxBsrGrowthRatenumber

Maximum BSR growth rate, unit %

minBsrGrowthCountinteger

Minimum BSR growth count

maxBsrGrowthCountinteger

Maximum main category BSR growth count

minSubNodeBsrRankinteger

Lowest subcategory BSR rank (requires filterSubNode = true)

maxSubNodeBsrRankinteger

Highest subcategory BSR rank (requires filterSubNode = true)

minRatingnumber

Minimum rating value (0-5)

maxRatingnumber

Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range

minRatingsinteger

Minimum review count (0-10000)

maxRatingsinteger

Maximum review count (0-10000)

minRatingsGrowthCountinteger

Minimum monthly new review count (>= 0)

maxRatingsGrowthCountinteger

Maximum monthly new review count (>= 0)

minListingQualityScorenumber

Minimum Listing page quality score (>= 0)

maxListingQualityScorenumber

Maximum Listing page quality score (>= 0)

minVariationsinteger

Minimum number of variations

maxVariationsinteger

Maximum number of variations

minWeightsnumber

Minimum weight (>= 0)

maxWeightsnumber

Maximum weight (>= 0)

weightUnitstring

Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering

dimensionTypestring

Package dimension type (codes vary by site, see below)

minSellersinteger

Minimum number of sellers

maxSellersinteger

Maximum number of sellers

badgeBestSellerstring

Best Seller badge filter: Y, N, or empty (all)

badgeAmazonsChoicestring

Amazon's Choice badge filter: Y, N, or empty (all)

badgeNewReleasestring

New Release badge filter: Y, N, or empty (all)

fulfillmentstring

Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit

showVariationstring

Whether to query variants: Y or N, default N

hideUnlistedProductboolean

Whether to hide delisted products, default true

listedWithinLastMonthsinteger

Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers)

sellerNationstring

Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit

includeSellersstring

Include sellers; maxLength 10240

excludeSellersstring

Exclude sellers; maxLength 10240

includeBrandsstring

Include brands; maxLength 10240

excludeBrandsstring

Exclude brands; maxLength 10240

pageinteger

Page number, starting from 1, default 1

sizeinteger

Results per page (10-100), default 20

Example request

{
  "marketplace": "US",
  "matchType": 1,
  "keyword": "phone case",
  "size": 20,
  "page": 1
}

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,
    "products": [],
    "keyword": "phone case",
    "costToken": 1
  }
}

Changes

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