https://api.nexscope.ai/jm/productDiscoveryRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/jm/productDiscovery |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | required | Keywords (required, and according to the selected country, translate the keywords into the language of the corresponding country) |
countryCode | string | optional | For countries, use the country abbreviation. Default `US`. Optional values: `US`, `JP`, `DE` |
priceMin | number | optional | lowest product price |
priceMax | number | optional | Maximum product price |
totalReviewsMin | integer | optional | Minimum number of comments |
totalReviewsMax | integer | optional | Highest number of comments |
customerRatingMin | number | optional | lowest rating |
customerRatingMax | number | optional | highest rating |
clickConversionRateMin | number | optional | Minimum click-to-purchase conversion rate, the value range is 0-1, 0.1 means 10% |
clickConversionRateMax | number | optional | The highest click-to-purchase conversion rate, the value range is 0-1, 0.1 means 10% |
clickConversionRateCompositeMin | number | optional | Minimum comprehensive conversion rate, the value range is 0-1, 0.1 means 10% |
clickConversionRateCompositeMax | number | optional | The highest comprehensive conversion rate, the value range is 0-1, 0.1 means 10% |
clickCountT7Min | integer | optional | Minimum weekly clicks |
clickCountT7Max | integer | optional | Highest number of clicks per week |
clickCountT30Min | integer | optional | Minimum monthly clicks |
clickCountT30Max | integer | optional | Highest monthly clicks |
clickCountGrowthT7Min | number | optional | Minimum weekly click growth rate, the value range is 0-1, 0.1 means 10% |
clickCountGrowthT7Max | number | optional | The highest weekly click growth rate, the value range is 0-1, 0.1 means 10% |
clickCountGrowthT30Min | number | optional | Minimum monthly click growth rate, the value range is 0-1, 0.1 means 10% |
clickCountGrowthT30Max | number | optional | The highest monthly click growth rate, the value range is 0-1, 0.1 means 10% |
salesVolumeT360Min | integer | optional | Minimum annual sales volume |
salesVolumeT360Max | integer | optional | highest annual sales volume |
grossProfitMarginMin | number | optional | Minimum gross profit margin |
grossProfitMarginMax | number | optional | Highest gross profit margin |
fbaFeeMin | number | optional | Minimum FBA commission |
fbaFeeMax | number | optional | Highest FBA commission |
launchDateMin | string | optional | Minimum shelf time, the format is: `yyyyMMdd000000` |
launchDateMax | string | optional | The maximum shelf time, the format is: `yyyyMMdd000000` |
nicheCountMin | integer | optional | Minimum number of segments |
nicheCountMax | integer | optional | Highest number of market segments |
sellerCountry | string | optional | Seller's country and region code. If multiple selections are made, separate them with commas, such as: `CN,US` |
sortField | string | optional | 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) |
sortType | string | optional | Sort by. Default `desc`. Optional values: `desc` (descending order), `asc` (ascending order) |
page | integer | optional | Page number. Default `1` |
pageSize | integer | optional | 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
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.asin | any | optional | Asin value used by this API operation. |
data.asinUrl | any | optional | Asin url value used by this API operation. |
data.availableDate | any | optional | Available date value used by this API operation. |
data.availableDateString | any | optional | Available date string value used by this API operation. |
data.brand | any | optional | Brand value used by this API operation. |
data.categoryNames | any | optional | Category names value used by this API operation. |
data.clickConversionRate | any | optional | Click conversion rate value used by this API operation. |
data.clickConversionRateComposite | any | optional | Click conversion rate composite value used by this API operation. |
data.clickCountT30 | any | optional | Click count t30 value used by this API operation. |
data.clickCountT7 | any | optional | Click count t7 value used by this API operation. |
data.clickCountT90 | any | optional | Click count t90 value used by this API operation. |
data.columns | any | optional | Columns value used by this API operation. |
data.costTime | any | optional | Cost time value used by this API operation. |
data.costToken | any | optional | Cost token value used by this API operation. |
data.dataSnapshotMonth | any | optional | Data snapshot month value used by this API operation. |
data.fbaFee | any | optional | Fba fee value used by this API operation. |
data.grossProfitMargin | any | optional | Gross profit margin value used by this API operation. |
data.imageUrl | any | optional | Image url value used by this API operation. |
data.marketplaceId | any | optional | Marketplace id value used by this API operation. |
data.page | any | optional | Page value used by this API operation. |
data.pageItemCount | any | optional | Page item count value used by this API operation. |
data.pageSize | any | optional | Page size value used by this API operation. |
data.parentAsin | any | optional | Parent asin value used by this API operation. |
data.price | any | optional | Price value used by this API operation. |
data.productImageUrls | any | optional | Product image urls value used by this API operation. |
data.products | any | optional | Products value used by this API operation. |
data.ratings | any | optional | Ratings value used by this API operation. |
data.shippingFee | any | optional | Shipping fee value used by this API operation. |
data.sourceTool | any | optional | Source tool value used by this API operation. |
data.sourceType | any | optional | Source type value used by this API operation. |
data.title | any | optional | Title value used by this API operation. |
data.total | any | optional | Total value used by this API operation. |
data.totalPage | any | optional | Total page value used by this API operation. |
data.type | any | optional | Type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.asin | string | optional | Amazon product ASIN Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.asin | null | optional | Asin value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.asinUrl | string | optional | ASIN link Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.asinUrl | null | optional | Asin url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.availableDate | string | optional | Release time (timestamp) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.availableDate | null | optional | Available date value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.availableDateString | string | optional | Release date (string) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.availableDateString | null | optional | Available date string value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.brand | string | optional | brand Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.brand | null | optional | Brand value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.categoryNames | array | optional | Category information Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.categoryNames | null | optional | Category names value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRate | number | optional | Click to purchase conversion rate Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRate | null | optional | Click conversion rate value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRateComposite | number | optional | Comprehensive conversion rate Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRateComposite | null | optional | Click conversion rate composite value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT30 | integer | optional | Clicks per month Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT30 | null | optional | Click count t30 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT7 | integer | optional | Clicks per week Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT7 | null | optional | Click count t7 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT90 | integer | optional | Quarterly hits Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT90 | null | optional | Click count t90 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | array | optional | Rendered columns Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | null | optional | Columns value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | null | optional | Cost time value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | integer | optional | Consume token Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | null | optional | Cost token value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | null | optional | Data snapshot month value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.fbaFee | number | optional | Amazon commission Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.fbaFee | null | optional | Fba fee value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.grossProfitMargin | number | optional | Gross profit margin Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.grossProfitMargin | null | optional | Gross profit margin value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | string | optional | Product main picture Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | null | optional | Image url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.marketplaceId | string | optional | Site ID Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.marketplaceId | null | optional | Marketplace id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.page | null | optional | Page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | null | optional | Page item count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | null | optional | Page size value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.parentAsin | string | optional | Amazon Product Parent ASIN Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.parentAsin | null | optional | Parent asin value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.price | number | optional | price Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.price | null | optional | Price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.productImageUrls | array | optional | Product image link list Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.productImageUrls | null | optional | Product image urls value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.products | array | optional | Product List (see details below) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.products | null | optional | Products value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.ratings | integer | optional | Number of comments Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.ratings | null | optional | Ratings value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.shippingFee | number | optional | FBA freight Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.shippingFee | null | optional | Shipping fee value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | null | optional | Source tool value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | any | optional | Source type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | string | optional | Source type: `amazon` Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | null | optional | Source type value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | null | optional | Source type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.title | any | optional | Title value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.title | string | optional | product title Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.title | null | optional | Title value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.title | null | optional | Title value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.total | integer | optional | total Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.total | null | optional | Total value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | null | optional | Total page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.type | string | optional | Rendering style Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.type | null | optional | Type value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Responses
| Code | Description |
|---|---|
| 200 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-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.