https://api.nexscope.ai/jm/pageAsinsByAsinRun 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/pageAsinsByAsin |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
asin | string | required | Reference ASIN is used to query the list of competing products belonging to the same market segment (Niche) as the ASIN. The maximum length is 1000 characters. |
countryCode | string | optional | Country code, optional values: `US` (United States), `JP` (Japan), `DE` (Germany) Example: US |
page | integer | optional | Page number (starting from 1) Example: 1 |
pageSize | integer | optional | Number of returns per page (10-100) Example: 50 |
sortField | string | optional | Sorting field (see sorting options below) Example: purchasedClicksT360 |
sortType | string | optional | Sort by: `desc` (descending) or `asc` (ascending) Example: desc |
priceMin | number | optional | lowest product price |
priceMax | number | optional | Maximum product price |
fbaFeeMin | number | optional | Minimum FBA commission |
fbaFeeMax | number | optional | Highest FBA commission |
grossProfitMarginMin | number | optional | Minimum gross profit margin |
grossProfitMarginMax | number | optional | Highest gross profit margin |
totalReviewsMin | integer | optional | Minimum number of comments |
totalReviewsMax | integer | optional | Maximum number of comments |
customerRatingMin | number | optional | Minimum rating, value range 0.0-5.0 |
customerRatingMax | number | optional | Highest rating, value range 0.0-5.0 |
clickCountT7Min | integer | optional | Minimum weekly clicks |
clickCountT7Max | integer | optional | Highest number of clicks per week |
clickCountGrowthT7Min | number | optional | Minimum weekly click growth rate, value range 0-1, for example, 0.1 means 10% |
clickCountGrowthT7Max | number | optional | The highest weekly click growth rate, the value range is 0-1, for example, 0.1 means 10% |
clickConversionRateMin | number | optional | Minimum click conversion rate, value range 0-1, for example, 0.1 means 10% |
clickConversionRateMax | number | optional | The highest click conversion rate, the value range is 0-1, for example, 0.1 means 10% |
clickCountT30Min | integer | optional | Minimum monthly clicks |
clickCountT30Max | integer | optional | Highest monthly clicks |
clickCountGrowthT30Min | number | optional | Minimum monthly click growth rate, value range 0-1, for example, 0.1 means 10% |
clickCountGrowthT30Max | number | optional | The highest monthly click growth rate, the value range is 0-1, for example, 0.1 means 10% |
clickConversionRateCompositeMin | number | optional | Minimum comprehensive click conversion rate, value range 0-1, for example, 0.1 means 10% |
clickConversionRateCompositeMax | number | optional | The highest comprehensive click conversion rate, the value range is 0-1, for example, 0.1 means 10% |
salesVolumeT360Min | integer | optional | Minimum annual sales volume |
salesVolumeT360Max | integer | optional | Highest annual sales |
launchDateMin | string | optional | The earliest release time, in the format of yyyyMMdd000000 |
launchDateMax | string | optional | The latest release date, in the format of yyyyMMdd000000 |
nicheCountMin | integer | optional | Minimum number of segments |
nicheCountMax | integer | optional | Maximum number of market segments |
sellerCountry | string | optional | The country code of the seller's country. If you select multiple countries, separate them with English commas, such as: CN, US |
Code example
{
"asin": "B0GC4RPX79",
"countryCode": "US",
"page": 1,
"pageSize": 50,
"sortField": "purchasedClicksT360",
"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.bestSellersRanking | any | optional | Best sellers ranking 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.clickConversionRateCompositeType | any | optional | Click conversion rate composite type value used by this API operation. |
data.clickConversionRateType | any | optional | Click conversion rate type value used by this API operation. |
data.clickCountGrowthT30 | any | optional | Click count growth t30 value used by this API operation. |
data.clickCountGrowthT7 | any | optional | Click count growth t7 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.currency | any | optional | Currency value used by this API operation. |
data.currentPrice | any | optional | Current price value used by this API operation. |
data.customerRating | any | optional | Customer rating value used by this API operation. |
data.data | any | optional | Data 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.gpm | any | optional | Gpm value used by this API operation. |
data.hasMetric | any | optional | Has metric value used by this API operation. |
data.imagesUrl | any | optional | Images url value used by this API operation. |
data.involvedFrequency | any | optional | Involved frequency value used by this API operation. |
data.involvedNum | any | optional | Involved num value used by this API operation. |
data.lastUpdateTime | any | optional | Last update time value used by this API operation. |
data.launchDate | any | optional | Launch date value used by this API operation. |
data.link | any | optional | Link value used by this API operation. |
data.nicheCount | any | optional | Niche count value used by this API operation. |
data.niches | any | optional | Niches 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.pages | any | optional | Pages 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.purchasedClicksT360 | any | optional | Purchased clicks t360 value used by this API operation. |
data.salesVolumeT360 | any | optional | Sales volume t360 value used by this API operation. |
data.sameNicheTitle | any | optional | Same niche title value used by this API operation. |
data.searchValueType | any | optional | Search value type value used by this API operation. |
data.sellerId | any | optional | Seller id value used by this API operation. |
data.sellerName | any | optional | Seller name 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.totalReviews | any | optional | Total reviews value used by this API operation. |
data.trends | any | optional | Trends 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.bestSellersRanking | array | optional | Bestseller list ranking, including: rank (ranking), category (category name) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.bestSellersRanking | null | optional | Best sellers ranking 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 conversion rate (original 7-day click 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 click 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.clickConversionRateCompositeType | string | optional | Comprehensive conversion rate calculation type Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRateCompositeType | null | optional | Click conversion rate composite type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRateType | string | optional | Conversion rate calculation type Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickConversionRateType | null | optional | Click conversion rate type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountGrowthT30 | number | optional | Monthly click growth rate Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountGrowthT30 | null | optional | Click count growth t30 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountGrowthT7 | number | optional | Weekly click growth rate Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountGrowthT7 | null | optional | Click count growth t7 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.clickCountT30 | integer | optional | Clicks in 30 days 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 in 7 days 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 | Clicks in 90 days 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.currency | string | optional | Currency Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.currency | null | optional | Currency value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.currentPrice | number | optional | current price Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.currentPrice | null | optional | Current price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.customerRating | number | optional | Rating Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.customerRating | null | optional | Customer rating value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.data | array | optional | ASIN product list (see product object fields below) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.data | null | optional | Data 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 | FBA 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.gpm | number | optional | Gross profit margin Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.gpm | null | optional | Gpm value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.hasMetric | boolean | optional | Identifies whether there are indicators Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.hasMetric | null | optional | Has metric value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.imagesUrl | string | optional | Product main picture Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.imagesUrl | null | optional | Images url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.involvedFrequency | integer | optional | Involved keyword frequency Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.involvedFrequency | null | optional | Involved frequency value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.involvedNum | integer | optional | The number of keywords involved Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.involvedNum | null | optional | Involved num value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.lastUpdateTime | string | optional | Last updated Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.lastUpdateTime | null | optional | Last update time value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.launchDate | string | optional | Shelf time Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.launchDate | null | optional | Launch date value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.link | string | optional | ASIN link Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.link | null | optional | Link value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheCount | integer | optional | Number of market segments to which it belongs Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheCount | null | optional | Niche count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.niches | array | optional | top3 market segments, including: nicheId, nicheTitle, demand (market score), image, marketplaceId Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.niches | null | optional | Niches value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.page | integer | optional | Current page 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 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.pages | integer | optional | Total pages Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pages | null | optional | Pages 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.purchasedClicksT360 | integer | optional | 360 days purchase click Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.purchasedClicksT360 | null | optional | Purchased clicks t360 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.salesVolumeT360 | integer | optional | annual sales Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.salesVolumeT360 | null | optional | Sales volume t360 value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sameNicheTitle | string | optional | Same market segment (Niche) title Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sameNicheTitle | null | optional | Same niche title value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.searchValueType | string | optional | Search type: exact (exact match), sameNiche (belongs to the same market segment as the reference ASIN), category (category) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.searchValueType | null | optional | Search value type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerId | string | optional | Seller ID Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerId | null | optional | Seller id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerName | string | optional | Seller name Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerName | null | optional | Seller name 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 | string | optional | Provider-specific source platform type. 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 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 1
| Name | Type | Required | Description |
|---|---|---|---|
data.total | integer | optional | Total number of records 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.totalReviews | integer | optional | Number of comments Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.totalReviews | null | optional | Total reviews value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.trends | array | optional | 90-day trend data, including: day (date), clickCountT7 (weekly clicks), reviewCount (number of reviews), reviewRating (rating), bestSellerRanking (BSR ranking), averagePriceT7 (weekly average price), totalOfferDepthT7 (new offers in 7 days) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.trends | null | optional | Trends 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.