https://claw-callback.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 direct response payload.
Endpoint
| Method | POST |
| Path | https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| 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 |
Request example
{
"countryCode": "US",
"keyword": "phone case",
"pageSize": 10,
"page": 1
}Response body
Returns the documented upstream API response directly without an additional wrapper.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Total count Example: 1 |
data | array | optional | Niche market review list (see data item fields below for details) Example: [] |
columns | array | optional | Render columns Example: [] |
costToken | integer | optional | Tokens consumed Example: 1 |
type | string | optional | Render style |
title | string | optional | Title |
data[].nicheId | string | optional | Niche market ID Example: example-id |
data[].nicheName | string | optional | Niche market name |
data[].keyword | string | optional | Keyword Example: phone case |
data[].reviewType | string | optional | Review type (values: [Positive Reviews], [Negative Reviews]) |
data[].topic | string | optional | Review topic |
data[].percentOfMentions | number | optional | Share (range 0-1, representing 0%-100%) Example: 1 |
data[].reviewExample | string | optional | Review example |
errcode | integer | optional | Upstream status code returned by the provider. |
errmsg | string | optional | Upstream status message returned by the provider. |
code | string | optional | Provider-specific status code. |
msg | string | optional | Provider-specific status message. |
message | string | optional | Provider-specific message. |
sourceType | string | optional | Provider-specific source platform type. |
sourceTool | string | optional | Provider-specific source tool name. |
costTime | integer | optional | Execution time reported by the upstream provider. |
page | integer | optional | Current page returned by the upstream provider. |
pageSize | integer | optional | Page size returned by the upstream provider. |
pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. |
totalPage | integer | optional | Total page count returned by the upstream provider. |
dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. |
Response example
Direct response payload. No extra wrapper is added.
{
"total": 1,
"data": [
{
"nicheId": "example-id",
"keyword": "phone case",
"percentOfMentions": 1
}
],
"columns": [],
"costToken": 1
}Responses
| Code | Description |
|---|---|
| 200 | API executed successfully. Body is the direct response payload. |
| 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.