Nexscope

Amazon Niche Reviews By Keyword

Amazon niche market review analysis and consumer sentiment insights.

Cost12 credits / call
POST · https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/runMCP · nexscope_amazon_niche_reviews_by_keyword

Choose an integration method

Keyword & Search Demand

What this API does

Amazon niche market review analysis and consumer sentiment insights.

Try this API
Endpoint
https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run
MCP method
nexscope_amazon_niche_reviews_by_keyword

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run

Run an API

Request parameters documented by ecommerce.amazon-niche-reviews-by-keyword.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "countryCode": "US",
  "keyword": "phone case",
  "page": 1,
  "pageSize": 10
}'

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

CodeDescription
200HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.
All categories/ Keyword & Search Demand
POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
keywordstringrequired
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
countryCodestringoptional
Country code, options: US (United States), JP (Japan), DE (Germany)
pageintegeroptional
Page number (starting from 1)
Example: 1
pageSizeintegeroptional
Results per page (10-100)
Example: 10
sortFieldstringoptional
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)
sortTypestringoptional
Sort direction, options: desc (descending), asc (ascending)
productCountMinintegeroptional
Minimum product count (current)
Example: 1
productCountMaxintegeroptional
Maximum product count (current)
Example: 1
brandCountMinintegeroptional
Minimum brand count
Example: 1
brandCountMaxintegeroptional
Maximum brand count
Example: 1
avgPriceMinnumberoptional
Minimum average price (current)
Example: 1
avgPriceMaxnumberoptional
Maximum average price (current)
Example: 1
unitsSoldT7Minintegeroptional
Minimum sales volume (7-day stats)
Example: 1
unitsSoldT7Maxintegeroptional
Maximum sales volume (7-day stats)
Example: 1
searchVolumeT7Minintegeroptional
Minimum search volume (7-day stats)
Example: 1
searchVolumeT7Maxintegeroptional
Maximum search volume (7-day stats)
Example: 1
clickCountT7Minintegeroptional
Minimum click volume (7-day stats)
Example: 1
clickCountT7Maxintegeroptional
Maximum click volume (7-day stats)
Example: 1
clickConversionRateT7Minnumberoptional
Minimum click conversion rate (7-day stats)
Example: 1
clickConversionRateT7Maxnumberoptional
Maximum click conversion rate (7-day stats)
Example: 1
top5BrandsClickShareMinnumberoptional
Minimum top 5 brands' click share in the niche market
Example: 1
top5BrandsClickShareMaxnumberoptional
Maximum top 5 brands' click share in the niche market
Example: 1
top5ProductsClickShareMinnumberoptional
Minimum top 5 products click share (current)
Example: 1
top5ProductsClickShareMaxnumberoptional
Maximum top 5 products click share (current)
Example: 1
sponsoredProductsPercentageMinnumberoptional
Minimum SP ad share
Example: 1
sponsoredProductsPercentageMaxnumberoptional
Maximum SP ad share
Example: 1
avgBrandAgeMinnumberoptional
Minimum average brand age (current)
Example: 1
avgBrandAgeMaxnumberoptional
Maximum average brand age (current)
Example: 1
avgBrandAgeQoqMinnumberoptional
Minimum average brand age (90-day stats)
Example: 1
avgBrandAgeQoqMaxnumberoptional
Maximum average brand age (90-day stats)
Example: 1
avgBrandAgeYoyMinnumberoptional
Minimum average brand age (360-day stats)
Example: 1
avgBrandAgeYoyMaxnumberoptional
Maximum average brand age (360-day stats)
Example: 1
avgSellingPartnerAgeMinnumberoptional
Minimum average selling partner age
Example: 1
avgSellingPartnerAgeMaxnumberoptional
Maximum average selling partner age
Example: 1
avgSellingPartnerAgeQoqMinnumberoptional
Minimum average selling partner age (90-day stats)
Example: 1
avgSellingPartnerAgeQoqMaxnumberoptional
Maximum average selling partner age (90-day stats)
Example: 1
avgSellingPartnerAgeYoyMinnumberoptional
Minimum average selling partner age (360-day stats)
Example: 1
avgSellingPartnerAgeYoyMaxnumberoptional
Maximum average selling partner age (360-day stats)
Example: 1
launchRateT180Minnumberoptional
Minimum product launch success rate (180-day stats)
Example: 1
launchRateT180Maxnumberoptional
Maximum product launch success rate (180-day stats)
Example: 1
newProductRateT180numberoptional
Minimum new product share (180-day stats)
Example: 1
returnRateT360Minnumberoptional
Minimum return rate (360-day stats)
Example: 1
returnRateT360Maxnumberoptional
Maximum return rate (360-day stats)
Example: 1
cpcMediumMinnumberoptional
Minimum CPC (current)
Example: 1
cpcMediumMaxnumberoptional
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

NameTypeRequiredDescription
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
dataanyrequired
Data value used by this API operation.
msgstring | nullrequired
Msg value used by this API operation.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
traceIdstring | nullrequired
Trace id value used by this API operation.
tsstringrequired
Epoch milliseconds.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.columnsarrayoptional
Render columns
Example: []
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.costTokenintegeroptional
Tokens consumed
Example: 1
data.dataarrayoptional
Niche market review list (see data item fields below for details)
Example: []
data.data[]objectrequired
Item in data data.
data.data[].keywordstringoptional
Keyword
Example: phone case
data.data[].nicheIdstringoptional
Niche market ID
Example: example-id
data.data[].nicheNamestringoptional
Niche market name
Example: null
data.data[].percentOfMentionsnumberoptional
Share (range 0-1, representing 0%-100%)
Example: 1
data.data[].reviewExamplestringoptional
Review example
Example: null
data.data[].reviewTypestringoptional
Review type (values: [Positive Reviews], [Negative Reviews])
Example: null
data.data[].topicstringoptional
Review topic
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.titlestringoptional
Title
Example: null
data.totalintegeroptional
Total count
Example: 1
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.typestringoptional
Render style
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Responses

CodeDescription
200HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI 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.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/api/skill-api/v2/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_niche_reviews_by_keyword",
    "arguments": {
      "countryCode": "US",
      "keyword": "phone case",
      "page": 1,
      "pageSize": 10
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /api/skill-api/v1/mcp

Online test

Execute the current API with your API key and JSON payload.

12 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run
MCP method
nexscope_amazon_niche_reviews_by_keyword
cURL
curl -X POST \
  https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "countryCode": "US", "keyword": "phone case", "page": 1, "pageSize": 10 }'
Response
No response yet. Run the request to see the response here.

Related APIs