https://api.nexscope.ai/api/skill-api/v1/skills/amazon-related-asins/runRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/api/skill-api/v1/skills/amazon-related-asins/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
asin | string | required | Reference ASIN, used to query competitor listings that belong to the same niche as this ASIN, max length 1000 characters Example: B072MQ5BRX |
countryCode | string | optional | Country code, options: US (United States), JP (Japan), DE (Germany) |
page | integer | optional | Page number (starting from 1) Example: 1 |
pageSize | integer | optional | Items returned per page (10-100) Example: 10 |
sortField | string | optional | Sort field (see sort options below) |
sortType | string | optional | Sort direction: desc (descending) or asc (ascending) |
priceMin | number | optional | Minimum product price Example: 1 |
priceMax | number | optional | Maximum product price Example: 1 |
fbaFeeMin | number | optional | Minimum FBA fee Example: 1 |
fbaFeeMax | number | optional | Maximum FBA fee Example: 1 |
grossProfitMarginMin | number | optional | Minimum gross profit margin Example: 1 |
grossProfitMarginMax | number | optional | Maximum gross profit margin Example: 1 |
totalReviewsMin | integer | optional | Minimum review count Example: 1 |
totalReviewsMax | integer | optional | Maximum review count Example: 1 |
customerRatingMin | number | optional | Minimum rating, range 0.0-5.0 Example: 1 |
customerRatingMax | number | optional | Maximum rating, range 0.0-5.0 Example: 1 |
clickCountT7Min | integer | optional | Minimum weekly click count Example: 1 |
clickCountT7Max | integer | optional | Maximum weekly click count Example: 1 |
clickCountGrowthT7Min | number | optional | Minimum weekly click growth rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickCountGrowthT7Max | number | optional | Maximum weekly click growth rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickConversionRateMin | number | optional | Minimum click conversion rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickConversionRateMax | number | optional | Maximum click conversion rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickCountT30Min | integer | optional | Minimum monthly click count Example: 1 |
clickCountT30Max | integer | optional | Maximum monthly click count Example: 1 |
clickCountGrowthT30Min | number | optional | Minimum monthly click growth rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickCountGrowthT30Max | number | optional | Maximum monthly click growth rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickConversionRateCompositeMin | number | optional | Minimum composite click conversion rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
clickConversionRateCompositeMax | number | optional | Maximum composite click conversion rate, range 0-1, e.g., 0.1 means 10% Example: 1 |
salesVolumeT360Min | integer | optional | Minimum annual sales volume Example: 1 |
salesVolumeT360Max | integer | optional | Maximum annual sales volume Example: 1 |
launchDateMin | string | optional | Earliest listing time, format yyyyMMdd000000 Example: 2026-01-01 |
launchDateMax | string | optional | Latest listing time, format yyyyMMdd000000 Example: 2026-01-01 |
nicheCountMin | integer | optional | Minimum number of niche markets Example: 1 |
nicheCountMax | integer | optional | Maximum number of niche markets Example: 1 |
sellerCountry | string | optional | Seller country code, comma-separated for multiple countries, e.g.: CN,US |
Code example
{
"asin": "B072MQ5BRX",
"countryCode": "US",
"page": 1,
"pageSize": 10
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {
"columns": [],
"costToken": 1,
"data": [
{
"asin": "B072MQ5BRX",
"bestSellersRanking": [],
"categoryNames": [],
"clickConversionRate": 1,
"clickConversionRateComposite": 1,
"clickCountGrowthT30": 1,
"clickCountGrowthT7": 1,
"clickCountT30": 1,
"clickCountT7": 1,
"clickCountT90": 1,
"currentPrice": 1,
"customerRating": 1,
"fbaFee": 1,
"gpm": 1,
"hasMetric": false,
"imagesUrl": "https://example.com/image.jpg",
"involvedFrequency": 1,
"involvedNum": 1,
"lastUpdateTime": "2026-01-01",
"launchDate": "2026-01-01",
"nicheCount": 1,
"niches": [],
"parentAsin": "B072MQ5BRX",
"price": 1,
"purchasedClicksT360": 1,
"salesVolumeT360": 1,
"sellerId": "example-id",
"shippingFee": 1,
"totalReviews": 1,
"trends": []
}
],
"page": 1,
"pageSize": 10,
"pages": 1,
"total": 1
},
"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.columns | array | optional | Rendered columns Example: [] |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.costToken | integer | optional | Token consumption Example: 1 |
data.data | array | optional | ASIN product list (see product object fields below) Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].asin | string | optional | Amazon product ASIN Example: B072MQ5BRX |
data.data[].bestSellersRanking | array | optional | Best seller rankings, containing: rank (ranking), category (category name) Example: [] |
data.data[].brand | string | optional | Brand Example: null |
data.data[].categoryNames | array | optional | Category information Example: [] |
data.data[].clickConversionRate | number | optional | Click conversion rate (original 7-day click conversion rate) Example: 1 |
data.data[].clickConversionRateComposite | number | optional | Composite click conversion rate Example: 1 |
data.data[].clickConversionRateCompositeType | string | optional | Composite conversion rate calculation type Example: null |
data.data[].clickConversionRateType | string | optional | Conversion rate calculation type Example: null |
data.data[].clickCountGrowthT30 | number | optional | Monthly click growth rate Example: 1 |
data.data[].clickCountGrowthT7 | number | optional | Weekly click growth rate Example: 1 |
data.data[].clickCountT30 | integer | optional | 30-day click count Example: 1 |
data.data[].clickCountT7 | integer | optional | 7-day click count Example: 1 |
data.data[].clickCountT90 | integer | optional | 90-day click count Example: 1 |
data.data[].currency | string | optional | Currency Example: null |
data.data[].currentPrice | number | optional | Current price Example: 1 |
data.data[].customerRating | number | optional | Rating Example: 1 |
data.data[].fbaFee | number | optional | FBA fee Example: 1 |
data.data[].gpm | number | optional | Gross profit margin Example: 1 |
data.data[].hasMetric | boolean | optional | Whether the product has metrics Example: false |
data.data[].imagesUrl | string | optional | Product main image Example: https://example.com/image.jpg |
data.data[].involvedFrequency | integer | optional | Frequency of involved keywords Example: 1 |
data.data[].involvedNum | integer | optional | Number of involved keywords Example: 1 |
data.data[].lastUpdateTime | string | optional | Last update time Example: 2026-01-01 |
data.data[].launchDate | string | optional | Listing time Example: 2026-01-01 |
data.data[].link | string | optional | ASIN link Example: null |
data.data[].nicheCount | integer | optional | Number of niche markets the product belongs to Example: 1 |
data.data[].niches | array | optional | Top 3 niche markets, containing: nicheId, nicheTitle, demand (market score), image, marketplaceId Example: [] |
data.data[].parentAsin | string | optional | Amazon product parent ASIN Example: B072MQ5BRX |
data.data[].price | number | optional | Price Example: 1 |
data.data[].purchasedClicksT360 | integer | optional | 360-day purchase clicks Example: 1 |
data.data[].salesVolumeT360 | integer | optional | Annual sales volume Example: 1 |
data.data[].sameNicheTitle | string | optional | Same niche title Example: null |
data.data[].searchValueType | string | optional | Search type: exact (exact match), sameNiche (same niche as reference ASIN), category (category) Example: null |
data.data[].sellerId | string | optional | Seller ID Example: example-id |
data.data[].sellerName | string | optional | Seller name Example: null |
data.data[].shippingFee | number | optional | FBA shipping fee Example: 1 |
data.data[].title | string | optional | Product title Example: null |
data.data[].totalReviews | integer | optional | Review count Example: 1 |
data.data[].trends | array | optional | 90-day trend data, containing: day (date), clickCountT7 (weekly click count), reviewCount (review count), reviewRating (review rating), bestSellerRanking (BSR ranking), averagePriceT7 (weekly average price), totalOfferDepthT7 (7-day new offers) Example: [] |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
data.page | integer | optional | Current page Example: 1 |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size, min 10, max 100 Example: 10 |
data.pages | integer | optional | Total page count Example: 1 |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.total | integer | optional | Total record count Example: 1 |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.type | string | optional | Render style Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 400 | Request JSON or required API parameters are invalid. |
| 401 | API key is missing, invalid, or cannot be matched to a user. |
| 5xx | API execution or upstream service failed. |
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.