Amazon Marketplace Intelligence

Amazon Opportunity Search By Metrics

Amazon reverse product selection: filter Amazon niches and keywords by 30+ business dimensions (market size & growth, price tiers & share, competition density & top concentration, demographics such as age/gender/income, review highlights & pain points) from a metrics pool aggregated from historical business insight reports. Trigger when users mention reverse product selection, metrics filtering, niche reverse lookup, blue ocean niche discovery, low-competition niche, newcomer-friendly niche, brand-fragmented market, pain-point entry, feature reverse lookup, pricing tier opportunity, demographic-based selection, or similar terms. Even if the user does not explicitly say "reverse product selection," trigger this skill whenever the request involves filtering Amazon niches that match specific business criteria.

post/api/skill-api/v1/skills/amazon-opportunity-search-by-metrics/run

Request

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

amazonDomainstring

Amazon site code (closed enum), currently only supports US. Defaults to US only if not specified

limitinteger

Maximum number of results to return (1-200), default 25. No page parameter; returns the most recent N records sorted by collection time descending

keywordstring

Search keyword text fragment (LIKE fuzzy match)

nicheNamestring

Normalized niche name fragment (LIKE, snake_case lowercase), suitable for niche time-series comparison

nicheRevenue360dMinUsdAtLeastGtenumber

Minimum 360-day market revenue lower bound (USD)

nicheRevenue360dMinUsdAtLeastLtenumber

Maximum 360-day market revenue lower bound (USD)

nicheRevenue360dMaxUsdAtLeastGtenumber

Minimum 360-day market revenue upper bound (USD)

nicheRevenue360dMaxUsdAtLeastLtenumber

Maximum 360-day market revenue upper bound (USD)

nichePeakSearchVolumeAtLeastGteinteger

Peak monthly search volume minimum (non-negative integer)

nichePeakSearchVolumeAtLeastLteinteger

Peak monthly search volume maximum (non-negative integer)

nicheSearchVolumeYoyChangePctAtLeastGtenumber

Search volume YoY change rate minimum (%, signed)

nicheSearchVolumeYoyChangePctAtLeastLtenumber

Search volume YoY change rate maximum (%, signed)

nichePeakMonthGteinteger

Search peak month minimum (1-12)

nichePeakMonthLteinteger

Search peak month maximum (1-12)

nicheBrandCountGteinteger

Active brand count minimum

nicheBrandCountLteinteger

Active brand count maximum

nicheBrandCountYoyChangePctAtLeastGtenumber

Brand count YoY change rate minimum (%, signed)

nicheBrandCountYoyChangePctAtLeastLtenumber

Brand count YoY change rate maximum (%, signed)

nicheTop5ProductClickSharePctAtLeastGtenumber

Top 5 product click share minimum (0-100)

nicheTop5ProductClickSharePctAtLeastLtenumber

Top 5 product click share maximum (0-100)

featureTop5BrandSharePctAtLeastGtenumber

Top 5 brand combined share minimum (0-100)

featureTop5BrandSharePctAtLeastLtenumber

Top 5 brand combined share maximum (0-100)

featureTopBrandsContainsstring

Top 3 brand name fragment (original text LIKE, case-sensitive)

priceMinUsdGtenumber

Niche minimum product price lower bound (USD)

priceMinUsdLtenumber

Niche minimum product price upper bound (USD)

priceMaxUsdGtenumber

Niche maximum product price lower bound (USD)

priceMaxUsdLtenumber

Niche maximum product price upper bound (USD)

priceSweetSpotMinUsdGtenumber

Sweet spot lower bound minimum (USD)

priceSweetSpotMinUsdLtenumber

Sweet spot lower bound maximum (USD)

priceSweetSpotMaxUsdGtenumber

Sweet spot upper bound minimum (USD)

priceSweetSpotMaxUsdLtenumber

Sweet spot upper bound maximum (USD)

priceEntryClickSharePctAtLeastGtenumber

Entry tier click share minimum (0-100)

priceEntryClickSharePctAtLeastLtenumber

Entry tier click share maximum (0-100)

priceMidClickSharePctAtLeastGtenumber

Mid tier click share minimum (0-100)

priceMidClickSharePctAtLeastLtenumber

Mid tier click share maximum (0-100)

priceHighClickSharePctAtLeastGtenumber

High tier click share minimum (0-100)

priceHighClickSharePctAtLeastLtenumber

High tier click share maximum (0-100)

demoPrimaryAgeMinGteinteger

Primary audience age lower bound minimum (0-120 years)

demoPrimaryAgeMinLteinteger

Primary audience age lower bound maximum (0-120 years)

demoPrimaryAgeMaxGteinteger

Primary audience age upper bound minimum (0-120 years)

demoPrimaryAgeMaxLteinteger

Primary audience age upper bound maximum (0-120 years)

demoGenderDominantstring

Dominant gender (closed enum): female / male / mixed / unspecified

demoPrimaryIncomeTierstring

Income tier (closed enum): low / middle_low / middle / middle_upper / upper_middle / high

demoLifeStageTagsContainsstring

Life stage tag fragment (snake_case, LIKE): parent, student, retiree, athlete, etc.

featureNewAvgReviewCountAtLeastGteinteger

New product average review count minimum (non-negative integer)

featureNewAvgReviewCountAtLeastLteinteger

New product average review count maximum (non-negative integer)

featureEstablishedAvgReviewCountAtLeastGteinteger

Established product average review count minimum (non-negative integer)

featureEstablishedAvgReviewCountAtLeastLteinteger

Established product average review count maximum (non-negative integer)

featureEmergingTrendTagsContainsstring

Emerging trend feature tag fragment (snake_case, LIKE): cordless, portable, smart, etc.

featureUncommonFeatureTagsContainsstring

Rare differentiation feature tag fragment (snake_case, LIKE): hema_free, medical_grade_silicone, etc.

searchTopCategory1Labelstring

Search traffic top category 1 label fragment (snake_case, LIKE): core_product_terms, set_kit_configurations, etc.

reviewPositiveTop1Topicstring

Positive review #1 topic fragment (snake_case, LIKE): comfort, quality_overall_generic, etc.

reviewPositiveTop1PctAtLeastGtenumber

Positive review #1 topic share minimum (0-100, share among positive reviews)

reviewPositiveTop1PctAtLeastLtenumber

Positive review #1 topic share maximum (0-100)

reviewNegativeTop1Topicstring

Negative review #1 topic fragment (snake_case, LIKE): size, quality, durability, etc.

reviewNegativeTop1PctAtLeastGtenumber

Negative review #1 topic share minimum (0-100, share among negative reviews)

reviewNegativeTop1PctAtLeastLtenumber

Negative review #1 topic share maximum (0-100)

reviewNegativeTop2Topicstring

Negative review #2 topic fragment (snake_case, LIKE)

reviewStrategicInsightTagsContainsstring

Review strategic insight tag fragment (snake_case, LIKE): sizing_clarity, material_transparency, etc.

Example request

{
  "limit": 10,
  "keyword": "phone case",
  "amazonDomain": "US"
}

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": {
    "data": []
  }
}

Changes

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