POST
https://api.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/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-market-product-search/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
marketplace | string | required | Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Example: us |
queryMode | integer | optional | Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship) Example: 1 |
queryType | integer | optional | Query type (1-16), only effective when queryMode=1. See the complete Query Types description in API.md Example: 1 |
queryValue | string | optional | Query condition value, format varies by queryMode and queryType. See the format description for each queryType in API.md Example: phone case |
page | integer | optional | Page number, default 1. Max 100 products per page Example: 1 |
queryMonth | string | optional | Historical month lookback, format yyyy-MM. When not specified, queries real-time data Example: 2026-01 |
Request example
{
"marketplace": "us",
"queryMode": 1,
"page": 1,
"queryValue": "B072MQ5BRX",
"queryType": 1
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Total result count Example: 1 |
data.page | integer | optional | Current page number Example: 1 |
data.pageCount | integer | optional | Total page count (max 200 pages) Example: 1 |
data.costTime | integer | optional | Latency (ms) Example: 1 |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.requestConsumed | integer | optional | Requests consumed Example: 1 |
data.type | string | optional | Render style Example: null |
data.columns | array | optional | Render columns Example: [] |
data.products | array | optional | Product list (see below) Example: [] |
data.products[].asin | string | optional | ASIN Example: B072MQ5BRX |
data.products[].title | string | optional | Product title Example: null |
data.products[].brand | string | optional | Brand Example: null |
data.products[].asinUrl | string | optional | Product link, Amazon Listing detail page URL Example: B072MQ5BRX |
data.products[].imageUrl | string | optional | Main image URL Example: https://example.com/image.jpg |
data.products[].productImageUrls | array | optional | Main image list (all product image URLs) Example: [] |
data.products[].parentAsin | string | optional | Parent ASIN, the parent ASIN if variants exist, null if no variants Example: B072MQ5BRX |
data.products[].variationNum | integer | optional | Number of variations Example: 1 |
data.products[].weight | string | optional | Weight, unit g Example: null |
data.products[].size | array | optional | Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm Example: [] |
data.products[].price | number | optional | Current price, before coupon, in local currency (e.g. USD) Example: 1 |
data.products[].oldPrice | number | optional | Strikethrough price, in local currency (e.g. USD) Example: 1 |
data.products[].salesPrice | number | optional | Final price, actual price after coupon deduction, in local currency (e.g. USD) Example: 1 |
data.products[].coupon | integer | optional | Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount) Example: 1 |
data.products[].fbaFees | number | optional | FBA fees, in local currency (e.g. USD) Example: 1 |
data.products[].fbaDetail | array | optional | FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"] Example: [] |
data.products[].platformFee | number | optional | Platform commission, in local currency (e.g. USD) Example: 1 |
data.products[].profitAmount | number | optional | Profit, final price - FBA fee - commission, in local currency (e.g. USD) Example: 1 |
data.products[].profitRate | number | optional | Profit margin, e.g. 25.83 means 25.83% Example: 1 |
data.products[].monthlySalesUnits | integer | optional | Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate Example: 1 |
data.products[].monthlySalesRevenue | number | optional | Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate Example: 1 |
data.products[].listingSalesVolumeOfDaily | integer | optional | Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate Example: 1 |
data.products[].listingSalesOfDaily | number | optional | Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate Example: 1 |
data.products[].salesRank | integer | optional | BSR rank, main category rank Example: 1 |
data.products[].category | array | optional | Main category, [category name, NodeId] Example: [] |
data.products[].bsrCategory | array | optional | Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd) Example: [] |
data.products[].rating | number | optional | Current rating (0.0-5.0, e.g. 4.8) Example: 1 |
data.products[].ratings | integer | optional | Number of ratings Example: 1 |
data.products[].availableDate | string | optional | Listing time, format yyyy-MM-dd Example: 2026-01-01 |
data.products[].onlineDays | integer | optional | Days since listing Example: 1 |
data.products[].buyboxSeller | string | optional | Buybox seller name Example: null |
data.products[].buyBoxSellerId | string | optional | Buybox seller ID Example: example-id |
data.products[].buyboxSellerAddress | string | optional | Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own Example: null |
data.products[].isFBA | boolean | optional | Whether FBA, whether Buybox seller uses FBA logistics Example: false |
data.products[].sellerNum | integer | optional | Number of sellers Example: 1 |
data.products[].aPlus | boolean | optional | Has A+ Example: false |
data.products[].hasVideo | boolean | optional | Has video Example: false |
data.products[].hasBrandStore | boolean | optional | Has brand store Example: false |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"data": {
"total": 1,
"page": 1,
"pageCount": 1,
"costTime": 1,
"costToken": 1,
"requestConsumed": 1,
"columns": [],
"products": [
{
"asin": "B072MQ5BRX",
"asinUrl": "B072MQ5BRX",
"imageUrl": "https://example.com/image.jpg",
"productImageUrls": [],
"parentAsin": "B072MQ5BRX",
"variationNum": 1,
"size": [],
"price": 1,
"oldPrice": 1,
"salesPrice": 1,
"coupon": 1,
"fbaFees": 1,
"fbaDetail": [],
"platformFee": 1,
"profitAmount": 1,
"profitRate": 1,
"monthlySalesUnits": 1,
"monthlySalesRevenue": 1,
"listingSalesVolumeOfDaily": 1,
"listingSalesOfDaily": 1,
"salesRank": 1,
"category": [],
"bsrCategory": [],
"rating": 1,
"ratings": 1,
"availableDate": "2026-01-01",
"onlineDays": 1,
"buyBoxSellerId": "example-id",
"isFBA": false,
"sellerNum": 1,
"aPlus": false,
"hasVideo": false,
"hasBrandStore": false
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}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.