Nexscope logo
Start free

Amazon Niche Info By Keyword API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Keyword & Search Demand

API overview

Deep analysis of Amazon niche markets by keyword, covering monopoly level, brand concentration, new product success rate, and market opportunity score.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run
MCP method
nexscope_amazon_niche_info_by_keyword

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 .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run

Run an API

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

Slugamazon-niche-info-by-keyword
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
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.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "countryCode": "US",   "keyword": "phone case",   "pageSize": 10,   "page": 1 }'
All categories/ Keyword & Search Demand
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run

Run this API

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

Open tester

Endpoint

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

Request body

NameTypeRequiredDescription
keywordstringrequired
Keyword (required, translate the keyword to the corresponding country's language based on the selected country), 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 (see sort options below)
sortTypestringoptional
Sort direction: desc (descending) or asc (ascending)
productCountMinintegeroptional
Minimum product count (current)
Example: 1
productCountMaxintegeroptional
Maximum product count (current)
Example: 1
avgPriceMinnumberoptional
Minimum average price (current)
Example: 1
avgPriceMaxnumberoptional
Maximum average price (current)
Example: 1
searchVolumeT7Minintegeroptional
Minimum search volume (7-day stats)
Example: 1
searchVolumeT7Maxintegeroptional
Maximum search volume (7-day stats)
Example: 1
unitsSoldT7Minintegeroptional
Minimum sales volume (7-day stats)
Example: 1
unitsSoldT7Maxintegeroptional
Maximum sales 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), range 0-1, representing 0%-100%
Example: 1
clickConversionRateT7Maxnumberoptional
Maximum click conversion rate (7-day stats), range 0-1, representing 0%-100%
Example: 1
brandCountMinintegeroptional
Minimum brand count
Example: 1
brandCountMaxintegeroptional
Maximum brand count
Example: 1
top5BrandsClickShareMinnumberoptional
Minimum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%
Example: 1
top5BrandsClickShareMaxnumberoptional
Maximum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%
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
top5ProductsClickShareMinnumberoptional
Minimum top 5 products click share (current), range 0-1, representing 0%-100%
Example: 1
top5ProductsClickShareMaxnumberoptional
Maximum top 5 products click share (current), range 0-1, representing 0%-100%
Example: 1
sponsoredProductsPercentageMinnumberoptional
Minimum SP ad share, range 0-1, representing 0%-100%
Example: 1
sponsoredProductsPercentageMaxnumberoptional
Maximum SP ad share, range 0-1, representing 0%-100%
Example: 1
cpcMediumMinnumberoptional
Minimum CPC (current)
Example: 1
cpcMediumMaxnumberoptional
Maximum CPC (current)
Example: 1
launchRateT180Minnumberoptional
Minimum product launch success rate (180-day stats), range 0-1, representing 0%-100%
Example: 1
launchRateT180Maxnumberoptional
Maximum product launch success rate (180-day stats), range 0-1, representing 0%-100%
Example: 1
newProductRateT180numberoptional
Minimum new product share (180-day stats), range 0-1, representing 0%-100%
Example: 1
returnRateT360Minnumberoptional
Minimum return rate (360-day stats), range 0-1, representing 0%-100%
Example: 1
returnRateT360Maxnumberoptional
Maximum return rate (360-day stats), range 0-1, representing 0%-100%
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.

NameTypeRequiredDescription
totalintegeroptional
Total count
Example: 1
dataarrayoptional
Niche market information list (see niche market object fields below)
Example: []
columnsarrayoptional
Render columns
Example: []
titlestringoptional
Title
typestringoptional
Render style
costTokenintegeroptional
Tokens consumed
Example: 1
data[].nicheIdstringoptional
Niche market ID
Example: example-id
data[].nicheTitlestringoptional
Niche market title
data[].translationZhstringoptional
Niche market title (Chinese)
data[].demandintegeroptional
Niche market score
Example: 1
data[].productCountintegeroptional
Product count
Example: 1
data[].avgPricenumberoptional
Average product price
Example: 1
data[].minimumPricenumberoptional
Lowest product price
Example: 1
data[].maximumPricenumberoptional
Highest product price
Example: 1
data[].searchVolumeWeeklyintegeroptional
Search volume (weekly data)
Example: 1
data[].searchVolumeQuarterlyintegeroptional
Search volume (quarterly data)
Example: 1
data[].searchVolumeGrowthWeeklynumberoptional
Search volume growth rate (weekly data)
Example: 1
data[].searchVolumeGrowthQuarterlynumberoptional
Search volume growth rate (quarterly data)
Example: 1
data[].unitsSoldWeeklyintegeroptional
Sales volume (weekly data)
Example: 1
data[].unitsSoldQuarterlyintegeroptional
Sales volume (quarterly data)
Example: 1
data[].clickCountWeeklyintegeroptional
Click volume (weekly data)
Example: 1
data[].clickCountQuarterlyintegeroptional
Click volume (quarterly data)
Example: 1
data[].clickToSaleConversionWeeklynumberoptional
Click conversion rate (weekly data)
Example: 1
data[].clickConversionRateQuarterlynumberoptional
Click conversion rate (quarterly data)
Example: 1
data[].searchConversionRateWeeklynumberoptional
Search conversion rate (weekly data)
Example: 1
data[].searchConversionRateQuarterlynumberoptional
Search conversion rate (quarterly data)
Example: 1
data[].brandCountintegeroptional
Brand count
Example: 1
data[].top5BrandsClickSharenumberoptional
Top 5 brands' click share in the niche market
Example: 1
data[].top5ProductsClickSharenumberoptional
Top 5 products click share
Example: 1
data[].avgBrandAgeNownumberoptional
Average brand age (current)
Example: 1
data[].avgBrandAgeQuarterlynumberoptional
Average brand age (quarterly data)
Example: 1
data[].newProductsLaunchedSemiannualintegeroptional
Number of new products launched (semi-annual data)
Example: 1
data[].successfulLaunchedSemiannualintegeroptional
Number of successfully launched products (semi-annual data)
Example: 1
data[].launchRateSemiannualnumberoptional
Product launch success rate (semi-annual data)
Example: 1
data[].returnRateAnnualnumberoptional
Return rate (annual data)
Example: 1
data[].acosnumberoptional
(ACOS) Advertising Cost of Sale
Example: 1
data[].profitMarginGt50PctSkuRationumberoptional
Proportion of products with profit margin > 50%
Example: 1
data[].breakEvenRationumberoptional
Break-even ratio
Example: 1
data[].cpcobjectoptional
CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }
Example: {}
data[].categorieListarrayoptional
Product category list
Example: []
data[].referenceAsinImageUrlstringoptional
Niche market reference image URL
Example: B072MQ5BRX
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
codestringoptional
Provider-specific status code.
msgstringoptional
Provider-specific status message.
messagestringoptional
Provider-specific message.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
costTimeintegeroptional
Execution time reported by the upstream provider.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "total": 1,
  "data": [
    {
      "nicheId": "example-id",
      "demand": 1,
      "productCount": 1,
      "avgPrice": 1,
      "minimumPrice": 1,
      "maximumPrice": 1,
      "searchVolumeWeekly": 1,
      "searchVolumeQuarterly": 1,
      "searchVolumeGrowthWeekly": 1,
      "searchVolumeGrowthQuarterly": 1,
      "unitsSoldWeekly": 1,
      "unitsSoldQuarterly": 1,
      "clickCountWeekly": 1,
      "clickCountQuarterly": 1,
      "clickToSaleConversionWeekly": 1,
      "clickConversionRateQuarterly": 1,
      "searchConversionRateWeekly": 1,
      "searchConversionRateQuarterly": 1,
      "brandCount": 1,
      "top5BrandsClickShare": 1,
      "top5ProductsClickShare": 1,
      "avgBrandAgeNow": 1,
      "avgBrandAgeQuarterly": 1,
      "newProductsLaunchedSemiannual": 1,
      "successfulLaunchedSemiannual": 1,
      "launchRateSemiannual": 1,
      "returnRateAnnual": 1,
      "acos": 1,
      "profitMarginGt50PctSkuRatio": 1,
      "breakEvenRatio": 1,
      "cpc": {},
      "categorieList": [],
      "referenceAsinImageUrl": "B072MQ5BRX"
    }
  ],
  "columns": [],
  "costToken": 1
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
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.

Related APIs

Amazon Asin Keywords

Use SIF data to reverse-lookup traffic keywords for any Amazon ASIN, including organic ranking, ad ranking, search volume, traffic share, organic/paid scores, ABA TOP3 click concentration, click conversion rate, year-over-year search volume changes, and weekly/monthly time windows.

Amazon Keyword Expansion

Jungle Scout keyword expansion tool that expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other metrics, covering 10 Amazon marketplaces including US, UK, DE, JP, etc.

Amazon Keyword Intelligence

Query and analyze Amazon ABA (Brand Analytics) search term data, covering 15 marketplaces with nearly 3 years of weekly data.

Amazon Keyword Overview

SIF overview analysis of Amazon keyword market competition.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

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

Online test

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

Try it

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

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