Amazon Marketplace Intelligence

Amazon Product Discovery

Amazon product discovery and potential bestseller mining via Nexscope data. Triggered when users mention product mining, potential bestsellers, high-conversion product selection, click growth analysis, market growth opportunities, keyword-based product selection, FBA profit screening, niche market product discovery, seller origin filtering, Nexscope data, FBA profitability screening, keyword-based product selection. Even if users do not explicitly mention "Nexscope", this skill should be triggered whenever the task involves keyword-driven Amazon product selection based on conversion rates, click volume, and profitability metrics.

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

Request

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

keywordstring required

Keyword (required; translate the keyword to the language of the selected country)

countryCodestring

Country, use country abbreviation. Default US. Options: US, JP, DE

priceMinnumber

Minimum product price

priceMaxnumber

Maximum product price

totalReviewsMininteger

Minimum number of reviews

totalReviewsMaxinteger

Maximum number of reviews

customerRatingMinnumber

Minimum rating

customerRatingMaxnumber

Maximum rating

clickConversionRateMinnumber

Minimum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%

clickConversionRateMaxnumber

Maximum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%

clickConversionRateCompositeMinnumber

Minimum composite conversion rate, value range 0-1, 0.1 means 10%

clickConversionRateCompositeMaxnumber

Maximum composite conversion rate, value range 0-1, 0.1 means 10%

clickCountT7Mininteger

Minimum weekly click count

clickCountT7Maxinteger

Maximum weekly click count

clickCountT30Mininteger

Minimum monthly click count

clickCountT30Maxinteger

Maximum monthly click count

clickCountGrowthT7Minnumber

Minimum weekly click growth rate, value range 0-1, 0.1 means 10%

clickCountGrowthT7Maxnumber

Maximum weekly click growth rate, value range 0-1, 0.1 means 10%

clickCountGrowthT30Minnumber

Minimum monthly click growth rate, value range 0-1, 0.1 means 10%

clickCountGrowthT30Maxnumber

Maximum monthly click growth rate, value range 0-1, 0.1 means 10%

salesVolumeT360Mininteger

Minimum annual sales volume

salesVolumeT360Maxinteger

Maximum annual sales volume

grossProfitMarginMinnumber

Minimum gross profit margin

grossProfitMarginMaxnumber

Maximum gross profit margin

fbaFeeMinnumber

Minimum FBA fee

fbaFeeMaxnumber

Maximum FBA fee

launchDateMinstring

Earliest listing time, format: yyyyMMdd000000

launchDateMaxstring

Latest listing time, format: yyyyMMdd000000

nicheCountMininteger

Minimum niche market count

nicheCountMaxinteger

Maximum niche market count

sellerCountrystring

Seller country/region code, comma-separated for multiple selections, e.g.: CN,US

sortFieldstring

Sort field. Default purchasedClicksT360. Options: totalReviews (total reviews), price (price), launchDate (listing time), clickCountT7 (7-day click count), clickCountT30 (30-day click count), clickCountT90 (90-day click count), clickConversionRate (click-to-purchase conversion rate), clickConversionRateComposite (composite click-to-purchase conversion rate), customerRating (rating), purchasedClicksT360 (360-day purchase clicks), clickCountGrowthT7 (weekly click growth rate), clickCountGrowthT30 (monthly click growth rate), currentPrice (current price), fbaFee (FBA fee), shippingFee (FBA shipping), gpm (gross profit margin)

sortTypestring

Sort direction. Default desc. Options: desc (descending), asc (ascending)

pageinteger

Page number. Default 1

pageSizeinteger

Items per page (10-100). Default 50

Example request

{
  "page": 1,
  "countryCode": "US",
  "keyword": "phone case",
  "pageSize": 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": {
    "total": 1,
    "costToken": 1,
    "products": []
  }
}

Changes

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