Nexscope

Amazon Product Discovery

Discover potential Amazon bestsellers for product research. Call the Amazon Product Discovery API via REST or MCP from 12 credits per call.

CostRecent 19 credits / call
Try online
POST · https://api.nexscope.ai/jm/productDiscoveryMCP · nexscope_amazon_product_discovery

Choose an integration method

Amazon Niche Intelligence JM

What this API does

Discover potential Amazon bestsellers for product research. The request accepts keyword, countryCode, priceMin, priceMax, totalReviewsMin. Its documented result includes asin, asinUrl, availableDate, availableDateString, brand, categoryNames, clickConversionRate, clickConversionRateComposite.

Amazon Product Discovery API use cases

Find products matching a sourcing brief

To find products matching a sourcing brief, a marketplace analyst submits keyword and countryCode to Amazon Product Discovery. The returned asin, asinUrl, availableDate help identify products matching the requested search criteria.

Compare a product search shortlist

A marketplace analyst uses Amazon Product Discovery with keyword and countryCode to compare a product search shortlist. The returned asin, asinUrl, availableDate help compare candidates before requesting individual product details.

Collect candidates for a market review

For this workflow, a marketplace analyst calls Amazon Product Discovery with keyword and countryCode to collect candidates for a market review. The result helps choose products for a supplier or competitor review.

Amazon Product Discovery API FAQ

What does the Amazon Product Discovery API return?

Discover potential Amazon bestsellers for product research. The documented output includes asin, asinUrl, availableDate, availableDateString, brand, categoryNames, clickConversionRate, clickConversionRateComposite. It corresponds to the supplied keyword, countryCode, priceMin, priceMax, totalReviewsMin. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the Amazon Product Discovery API cost?

The current documented cost is Recent 19 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Amazon Product Discovery API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/jm/productDiscovery with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_amazon_product_discovery. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/jm/productDiscovery
MCP method
nexscope_amazon_product_discovery

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/jm/productDiscovery

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/jm/productDiscovery' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "clickConversionRateMin": 0.1,
  "countryCode": "US",
  "keyword": "wireless charger",
  "page": 1,
  "pageSize": 20,
  "priceMax": 50,
  "priceMin": 10,
  "sortField": "clickConversionRate",
  "sortType": "desc"
}'

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.
All categories/ Amazon Niche Intelligence JM
POSThttps://api.nexscope.ai/jm/productDiscovery

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/jm/productDiscovery
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
keywordstringrequired
Keywords (required, and according to the selected country, translate the keywords into the language of the corresponding country)
countryCodestringoptional
For countries, use the country abbreviation. Default `US`. Optional values: `US`, `JP`, `DE`
priceMinnumberoptional
lowest product price
priceMaxnumberoptional
Maximum product price
totalReviewsMinintegeroptional
Minimum number of comments
totalReviewsMaxintegeroptional
Highest number of comments
customerRatingMinnumberoptional
lowest rating
customerRatingMaxnumberoptional
highest rating
clickConversionRateMinnumberoptional
Minimum click-to-purchase conversion rate, the value range is 0-1, 0.1 means 10%
clickConversionRateMaxnumberoptional
The highest click-to-purchase conversion rate, the value range is 0-1, 0.1 means 10%
clickConversionRateCompositeMinnumberoptional
Minimum comprehensive conversion rate, the value range is 0-1, 0.1 means 10%
clickConversionRateCompositeMaxnumberoptional
The highest comprehensive conversion rate, the value range is 0-1, 0.1 means 10%
clickCountT7Minintegeroptional
Minimum weekly clicks
clickCountT7Maxintegeroptional
Highest number of clicks per week
clickCountT30Minintegeroptional
Minimum monthly clicks
clickCountT30Maxintegeroptional
Highest monthly clicks
clickCountGrowthT7Minnumberoptional
Minimum weekly click growth rate, the value range is 0-1, 0.1 means 10%
clickCountGrowthT7Maxnumberoptional
The highest weekly click growth rate, the value range is 0-1, 0.1 means 10%
clickCountGrowthT30Minnumberoptional
Minimum monthly click growth rate, the value range is 0-1, 0.1 means 10%
clickCountGrowthT30Maxnumberoptional
The highest monthly click growth rate, the value range is 0-1, 0.1 means 10%
salesVolumeT360Minintegeroptional
Minimum annual sales volume
salesVolumeT360Maxintegeroptional
highest annual sales volume
grossProfitMarginMinnumberoptional
Minimum gross profit margin
grossProfitMarginMaxnumberoptional
Highest gross profit margin
fbaFeeMinnumberoptional
Minimum FBA commission
fbaFeeMaxnumberoptional
Highest FBA commission
launchDateMinstringoptional
Minimum shelf time, the format is: `yyyyMMdd000000`
launchDateMaxstringoptional
The maximum shelf time, the format is: `yyyyMMdd000000`
nicheCountMinintegeroptional
Minimum number of segments
nicheCountMaxintegeroptional
Highest number of market segments
sellerCountrystringoptional
Seller's country and region code. If multiple selections are made, separate them with commas, such as: `CN,US`
sortFieldstringoptional
Sort field. Default `purchasedClicksT360`. Optional values: `totalReviews` (total number of comments), `price` (price), `launchDate` (listing time), `clickCountT7` (7-day clicks), `clickCountT30` (30-day clicks), `clickCountT90` (90-day clicks), `clickConversionRate` (click-to-purchase conversion rate), `clickConversionRateComposite` (comprehensive click-to-purchase) conversion rate), `customerRating` (rating), `purchasedClicksT360` (360-day purchase volume), `clickCountGrowthT7` (weekly click growth rate), `clickCountGrowthT30` (monthly clicks Growth rate), `currentPrice` (current price), `fbaFee` (FBA commission), `shippingFee` (FBA freight), `gpm` (gross profit margin)
sortTypestringoptional
Sort by. Default `desc`. Optional values: `desc` (descending order), `asc` (ascending order)
pageintegeroptional
Page number. Default `1`
pageSizeintegeroptional
Quantity per page (10-100). Default `50`

Code example

{
  "clickConversionRateMin": 0.1,
  "countryCode": "US",
  "keyword": "wireless charger",
  "page": 1,
  "pageSize": 20,
  "priceMax": 50,
  "priceMin": 10,
  "sortField": "clickConversionRate",
  "sortType": "desc"
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Response fields

NameTypeRequiredDescription
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
dataanyrequired
Data value used by this API operation.
msgstring | nullrequired
Msg value used by this API operation.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
traceIdstring | nullrequired
Trace id value used by this API operation.
tsstringrequired
Epoch milliseconds.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.asinanyoptional
Asin value used by this API operation.
data.asinUrlanyoptional
Asin url value used by this API operation.
data.availableDateanyoptional
Available date value used by this API operation.
data.availableDateStringanyoptional
Available date string value used by this API operation.
data.brandanyoptional
Brand value used by this API operation.
data.categoryNamesanyoptional
Category names value used by this API operation.
data.clickConversionRateanyoptional
Click conversion rate value used by this API operation.
data.clickConversionRateCompositeanyoptional
Click conversion rate composite value used by this API operation.
data.clickCountT30anyoptional
Click count t30 value used by this API operation.
data.clickCountT7anyoptional
Click count t7 value used by this API operation.
data.clickCountT90anyoptional
Click count t90 value used by this API operation.
data.columnsanyoptional
Columns value used by this API operation.
data.costTimeanyoptional
Cost time value used by this API operation.
data.costTokenanyoptional
Cost token value used by this API operation.
data.dataSnapshotMonthanyoptional
Data snapshot month value used by this API operation.
data.fbaFeeanyoptional
Fba fee value used by this API operation.
data.grossProfitMarginanyoptional
Gross profit margin value used by this API operation.
data.imageUrlanyoptional
Image url value used by this API operation.
data.marketplaceIdanyoptional
Marketplace id value used by this API operation.
data.pageanyoptional
Page value used by this API operation.
data.pageItemCountanyoptional
Page item count value used by this API operation.
data.pageSizeanyoptional
Page size value used by this API operation.
data.parentAsinanyoptional
Parent asin value used by this API operation.
data.priceanyoptional
Price value used by this API operation.
data.productImageUrlsanyoptional
Product image urls value used by this API operation.
data.productsanyoptional
Products value used by this API operation.
data.ratingsanyoptional
Ratings value used by this API operation.
data.shippingFeeanyoptional
Shipping fee value used by this API operation.
data.sourceToolanyoptional
Source tool value used by this API operation.
data.sourceTypeanyoptional
Source type value used by this API operation.
data.titleanyoptional
Title value used by this API operation.
data.totalanyoptional
Total value used by this API operation.
data.totalPageanyoptional
Total page value used by this API operation.
data.typeanyoptional
Type value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.asinstringoptional
Amazon product ASIN
Example: null

Any of option 2

NameTypeRequiredDescription
data.asinnulloptional
Asin value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.asinUrlstringoptional
ASIN link
Example: null

Any of option 2

NameTypeRequiredDescription
data.asinUrlnulloptional
Asin url value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.availableDatestringoptional
Release time (timestamp)
Example: null

Any of option 2

NameTypeRequiredDescription
data.availableDatenulloptional
Available date value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.availableDateStringstringoptional
Release date (string)
Example: null

Any of option 2

NameTypeRequiredDescription
data.availableDateStringnulloptional
Available date string value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.brandstringoptional
brand
Example: null

Any of option 2

NameTypeRequiredDescription
data.brandnulloptional
Brand value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.categoryNamesarrayoptional
Category information
Example: null

Any of option 2

NameTypeRequiredDescription
data.categoryNamesnulloptional
Category names value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.clickConversionRatenumberoptional
Click to purchase conversion rate
Example: null

Any of option 2

NameTypeRequiredDescription
data.clickConversionRatenulloptional
Click conversion rate value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.clickConversionRateCompositenumberoptional
Comprehensive conversion rate
Example: null

Any of option 2

NameTypeRequiredDescription
data.clickConversionRateCompositenulloptional
Click conversion rate composite value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.clickCountT30integeroptional
Clicks per month
Example: null

Any of option 2

NameTypeRequiredDescription
data.clickCountT30nulloptional
Click count t30 value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.clickCountT7integeroptional
Clicks per week
Example: null

Any of option 2

NameTypeRequiredDescription
data.clickCountT7nulloptional
Click count t7 value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.clickCountT90integeroptional
Quarterly hits
Example: null

Any of option 2

NameTypeRequiredDescription
data.clickCountT90nulloptional
Click count t90 value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.columnsarrayoptional
Rendered columns
Example: null

Any of option 2

NameTypeRequiredDescription
data.columnsnulloptional
Columns value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.costTimenulloptional
Cost time value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.costTokenintegeroptional
Consume token
Example: null

Any of option 2

NameTypeRequiredDescription
data.costTokennulloptional
Cost token value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.dataSnapshotMonthnulloptional
Data snapshot month value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.fbaFeenumberoptional
Amazon commission
Example: null

Any of option 2

NameTypeRequiredDescription
data.fbaFeenulloptional
Fba fee value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.grossProfitMarginnumberoptional
Gross profit margin
Example: null

Any of option 2

NameTypeRequiredDescription
data.grossProfitMarginnulloptional
Gross profit margin value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.imageUrlstringoptional
Product main picture
Example: null

Any of option 2

NameTypeRequiredDescription
data.imageUrlnulloptional
Image url value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.marketplaceIdstringoptional
Site ID
Example: null

Any of option 2

NameTypeRequiredDescription
data.marketplaceIdnulloptional
Marketplace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pagenulloptional
Page value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pageItemCountnulloptional
Page item count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pageSizenulloptional
Page size value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.parentAsinstringoptional
Amazon Product Parent ASIN
Example: null

Any of option 2

NameTypeRequiredDescription
data.parentAsinnulloptional
Parent asin value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pricenumberoptional
price
Example: null

Any of option 2

NameTypeRequiredDescription
data.pricenulloptional
Price value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productImageUrlsarrayoptional
Product image link list
Example: null

Any of option 2

NameTypeRequiredDescription
data.productImageUrlsnulloptional
Product image urls value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productsarrayoptional
Product List (see details below)
Example: null

Any of option 2

NameTypeRequiredDescription
data.productsnulloptional
Products value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.ratingsintegeroptional
Number of comments
Example: null

Any of option 2

NameTypeRequiredDescription
data.ratingsnulloptional
Ratings value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.shippingFeenumberoptional
FBA freight
Example: null

Any of option 2

NameTypeRequiredDescription
data.shippingFeenulloptional
Shipping fee value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null

Any of option 2

NameTypeRequiredDescription
data.sourceToolnulloptional
Source tool value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sourceTypeanyoptional
Source type value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sourceTypestringoptional
Source type: `amazon`
Example: null

Any of option 2

NameTypeRequiredDescription
data.sourceTypenulloptional
Source type value used by this API operation.

Any of option 2

NameTypeRequiredDescription
data.sourceTypenulloptional
Source type value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.titleanyoptional
Title value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.titlestringoptional
product title
Example: null

Any of option 2

NameTypeRequiredDescription
data.titlenulloptional
Title value used by this API operation.

Any of option 2

NameTypeRequiredDescription
data.titlenulloptional
Title value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.totalintegeroptional
total
Example: null

Any of option 2

NameTypeRequiredDescription
data.totalnulloptional
Total value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.totalPagenulloptional
Total page value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.typestringoptional
Rendering style
Example: null

Any of option 2

NameTypeRequiredDescription
data.typenulloptional
Type value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Responses

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_discovery",
    "arguments": {
      "countryCode": "US",
      "keyword": "phone case",
      "page": 1,
      "pageSize": 10
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

12 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint
/jm/productDiscovery
MCP method
nexscope_amazon_product_discovery
cURL
curl -X POST \
  https://api.nexscope.ai/jm/productDiscovery \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "clickConversionRateMin": 0.1, "countryCode": "US", "keyword": "wireless charger", "page": 1, "pageSize": 20, "priceMax": 50, "priceMin": 10, "sortField": "clickConversionRate", "sortType": "desc" }'
Response
No response yet. Run the request to see the response here.

Related APIs