https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/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-niche-reviews-by-keyword/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | required | Keyword (required, use the language of the corresponding site, e.g. English for the US site, German for the Germany site), max length 1000 characters Example: phone case |
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 | Results per page (10-100) Example: 10 |
sortField | string | optional | Sort field, options: clickConversionRateT7 (7-day click conversion rate), demand (demand score), avgPrice (average product price), maximumPrice (highest product price), minimumPrice (lowest product price), productCount (product count), searchConversionRateT7 (7-day search conversion rate), searchVolumeT7 (7-day search volume), unitsSoldT7 (7-day sales volume), searchVolumeGrowthT7 (search growth rate), clickCountT90 (90-day click volume), clickCountT7 (weekly click volume), brandCount (brand count), top5BrandsClickShare (TOP5 brand share), newProductsLaunchedT180 (180-day new product success rate - launch count), successfulLaunchesT180 (180-day new product success rate - new product count), launchRateT180 (180-day new product success rate - launch rate), top5ProductsClickShare (top 5 product click share), returnRateT360 (return rate), clickConversionRateT90 (90-day click conversion rate), searchConversionRateT90 (90-day search conversion rate), searchVolumeT90 (90-day search volume), unitsSoldT90 (90-day sales volume), unitsSoldGrowthT90 (90-day sales growth rate), searchVolumeGrowthT90 (90-day search growth rate), acos, profitRate50 (profit rate for 50% natural orders) |
sortType | string | optional | Sort direction, options: desc (descending), asc (ascending) |
productCountMin | integer | optional | Minimum product count (current) Example: 1 |
productCountMax | integer | optional | Maximum product count (current) Example: 1 |
brandCountMin | integer | optional | Minimum brand count Example: 1 |
brandCountMax | integer | optional | Maximum brand count Example: 1 |
avgPriceMin | number | optional | Minimum average price (current) Example: 1 |
avgPriceMax | number | optional | Maximum average price (current) Example: 1 |
unitsSoldT7Min | integer | optional | Minimum sales volume (7-day stats) Example: 1 |
unitsSoldT7Max | integer | optional | Maximum sales volume (7-day stats) Example: 1 |
searchVolumeT7Min | integer | optional | Minimum search volume (7-day stats) Example: 1 |
searchVolumeT7Max | integer | optional | Maximum search volume (7-day stats) Example: 1 |
clickCountT7Min | integer | optional | Minimum click volume (7-day stats) Example: 1 |
clickCountT7Max | integer | optional | Maximum click volume (7-day stats) Example: 1 |
clickConversionRateT7Min | number | optional | Minimum click conversion rate (7-day stats) Example: 1 |
clickConversionRateT7Max | number | optional | Maximum click conversion rate (7-day stats) Example: 1 |
top5BrandsClickShareMin | number | optional | Minimum top 5 brands' click share in the niche market Example: 1 |
top5BrandsClickShareMax | number | optional | Maximum top 5 brands' click share in the niche market Example: 1 |
top5ProductsClickShareMin | number | optional | Minimum top 5 products click share (current) Example: 1 |
top5ProductsClickShareMax | number | optional | Maximum top 5 products click share (current) Example: 1 |
sponsoredProductsPercentageMin | number | optional | Minimum SP ad share Example: 1 |
sponsoredProductsPercentageMax | number | optional | Maximum SP ad share Example: 1 |
avgBrandAgeMin | number | optional | Minimum average brand age (current) Example: 1 |
avgBrandAgeMax | number | optional | Maximum average brand age (current) Example: 1 |
avgBrandAgeQoqMin | number | optional | Minimum average brand age (90-day stats) Example: 1 |
avgBrandAgeQoqMax | number | optional | Maximum average brand age (90-day stats) Example: 1 |
avgBrandAgeYoyMin | number | optional | Minimum average brand age (360-day stats) Example: 1 |
avgBrandAgeYoyMax | number | optional | Maximum average brand age (360-day stats) Example: 1 |
avgSellingPartnerAgeMin | number | optional | Minimum average selling partner age Example: 1 |
avgSellingPartnerAgeMax | number | optional | Maximum average selling partner age Example: 1 |
avgSellingPartnerAgeQoqMin | number | optional | Minimum average selling partner age (90-day stats) Example: 1 |
avgSellingPartnerAgeQoqMax | number | optional | Maximum average selling partner age (90-day stats) Example: 1 |
avgSellingPartnerAgeYoyMin | number | optional | Minimum average selling partner age (360-day stats) Example: 1 |
avgSellingPartnerAgeYoyMax | number | optional | Maximum average selling partner age (360-day stats) Example: 1 |
launchRateT180Min | number | optional | Minimum product launch success rate (180-day stats) Example: 1 |
launchRateT180Max | number | optional | Maximum product launch success rate (180-day stats) Example: 1 |
newProductRateT180 | number | optional | Minimum new product share (180-day stats) Example: 1 |
returnRateT360Min | number | optional | Minimum return rate (360-day stats) Example: 1 |
returnRateT360Max | number | optional | Maximum return rate (360-day stats) Example: 1 |
cpcMediumMin | number | optional | Minimum CPC (current) Example: 1 |
cpcMediumMax | number | optional | Maximum CPC (current) Example: 1 |
Code example
{
"countryCode": "US",
"keyword": "phone case",
"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": [
{
"keyword": "phone case",
"nicheId": "example-id",
"percentOfMentions": 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 | Render columns Example: [] |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.data | array | optional | Niche market review list (see data item fields below for details) Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].keyword | string | optional | Keyword Example: phone case |
data.data[].nicheId | string | optional | Niche market ID Example: example-id |
data.data[].nicheName | string | optional | Niche market name Example: null |
data.data[].percentOfMentions | number | optional | Share (range 0-1, representing 0%-100%) Example: 1 |
data.data[].reviewExample | string | optional | Review example Example: null |
data.data[].reviewType | string | optional | Review type (values: [Positive Reviews], [Negative Reviews]) Example: null |
data.data[].topic | string | optional | Review topic Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
data.page | integer | optional | Current page 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.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
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 | Title Example: null |
data.total | integer | optional | Total 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.