Nexscope logo

Amazon Niche Info 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
Amazon Marketplace Intelligence

API overview

Query and analyze Jiimore data for Amazon niche market insights, including market metrics, buyer reviews, competitive landscape, price trends, and growth trends.

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

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/run

Run an API

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

Slugamazon-niche-info
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/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "countryCode": "US",   "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0" }'
All categories/ Amazon Marketplace Intelligence
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info/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/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
nicheIdstringrequired
Niche market ID, max length 1000 characters, only supports single ID query
Example: dfecfecfa9701de73a08867d7bcd3bc0
countryCodestringoptional
Country code, only supports US, JP, DE, default US

Request example

{
  "countryCode": "US",
  "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0"
}

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
totalintegeroptional
Record count
Example: 1
dataarrayoptional
Niche market information list, each element is an object containing the fields below
Example: []
columnsarrayoptional
Render columns
Example: []
costTokenintegeroptional
Tokens consumed
Example: 1
typestringoptional
Render style
nicheIdstringoptional
Niche market ID
Example: dfecfecfa9701de73a08867d7bcd3bc0
data[].nicheTitlestringoptional
Niche market title
data[].translationZhstringoptional
Niche market title (Chinese)
referenceAsinImageUrlstringoptional
Niche market reference image URL
Example: B072MQ5BRX
marketplaceIdstringoptional
Market ID
Example: US
demandintegeroptional
Niche market score
Example: 1
categorieListarrayoptional
Product category list
Example: []
productCountintegeroptional
Product count
Example: 1
productCountNowintegeroptional
Product count (current)
Example: 1
productCountT90Beforeintegeroptional
Product count (90 days ago)
Example: 1
productCountT360Beforeintegeroptional
Product count (360 days ago)
Example: 1
brandCountintegeroptional
Brand count
Example: 1
brandCountNowintegeroptional
Brand count (current)
Example: 1
brandCountT90Beforeintegeroptional
Brand count (90 days ago)
Example: 1
brandCountT360Beforeintegeroptional
Brand count (360 days ago)
Example: 1
brandCountT360Nowintegeroptional
Brand count (360-day stats) (current)
Example: 1
brandCountT360T90Beforeintegeroptional
Brand count (360-day stats) (90 days ago)
Example: 1
brandCountT360T360Beforeintegeroptional
Brand count (360-day stats) (360 days ago)
Example: 1
sellingPartnerCountNowintegeroptional
Selling partner count (current)
Example: 1
sellingPartnerCountT90Beforeintegeroptional
Selling partner count (90 days ago)
Example: 1
sellingPartnerCountT360Beforeintegeroptional
Selling partner count (360 days ago)
Example: 1
sellingPartnerCountT360Nowintegeroptional
Selling partner count (360-day stats) (current)
Example: 1
sellingPartnerCountT360T90Beforeintegeroptional
Selling partner count (360-day stats) (90 days ago)
Example: 1
sellingPartnerCountT360T360Beforeintegeroptional
Selling partner count (360-day stats) (360 days ago)
Example: 1
avgPricenumberoptional
Average product price
Example: 1
avgProductPriceNownumberoptional
Average product price (current)
Example: 1
avgProductPriceT90Beforenumberoptional
Average product price (90 days ago)
Example: 1
avgProductPriceT360Beforenumberoptional
Average product price (360 days ago)
Example: 1
minimumPricenumberoptional
Lowest product price
Example: 1
maximumPricenumberoptional
Highest product price
Example: 1
searchVolumeWeeklyintegeroptional
Search volume (weekly data)
Example: 1
searchVolumeQuarterlyintegeroptional
Search volume (quarterly data)
Example: 1
searchVolumeGrowthWeeklynumberoptional
Search volume growth rate (weekly data)
Example: 1
searchVolumeGrowthQuarterlynumberoptional
Search volume growth rate (quarterly data)
Example: 1
searchConversionRateWeeklynumberoptional
Search conversion rate (weekly data)
Example: 1
searchConversionRateQuarterlynumberoptional
Search conversion rate (quarterly data)
Example: 1
clickCountWeeklyintegeroptional
Click volume (weekly data)
Example: 1
clickCountQuarterlyintegeroptional
Click volume (quarterly data)
Example: 1
clickConversionRateQuarterlynumberoptional
Click conversion rate (quarterly data)
Example: 1
clickToSaleConversionWeeklynumberoptional
Click conversion rate (weekly data)
Example: 1
unitsSoldWeeklyintegeroptional
Sales volume (weekly data)
Example: 1
unitsSoldQuarterlyintegeroptional
Sales volume (quarterly data)
Example: 1
top5ProductsClickSharenumberoptional
Top 5 products click share
Example: 1
top5ProductsClickShareNownumberoptional
Top 5 products' click share in the niche market (current)
Example: 1
top5ProductsClickShareT90Beforenumberoptional
Top 5 products' click share in the niche market (90 days ago)
Example: 1
top5ProductsClickShareT360Beforenumberoptional
Top 5 products' click share in the niche market (360 days ago)
Example: 1
top5ProductsClickShareT360Nownumberoptional
Top 5 products click share (360-day stats) (current)
Example: 1
top5ProductsClickShareT360T90Beforenumberoptional
Top 5 products click share (360-day stats) (90 days ago)
Example: 1
top5ProductsClickShareT360T360Beforenumberoptional
Top 5 products click share (360-day stats) (360 days ago)
Example: 1
top20ProductsClickShareNownumberoptional
Top 20 products' click share in the niche market (current)
Example: 1
top20ProductsClickShareT90Beforenumberoptional
Top 20 products' click share in the niche market (90 days ago)
Example: 1
top20ProductsClickShareT360Beforenumberoptional
Top 20 products' click share in the niche market (360 days ago)
Example: 1
top20ProductsClickShareT360Nownumberoptional
Top 20 products click share (360-day stats) (current)
Example: 1
top20ProductsClickShareT360T90Beforenumberoptional
Top 20 products click share (360-day stats) (90 days ago)
Example: 1
top20ProductsClickShareT360T360Beforenumberoptional
Top 20 products click share (360-day stats) (360 days ago)
Example: 1
top5BrandsClickSharenumberoptional
Top 5 brands' click share in the niche market
Example: 1
top5BrandsClickShareNownumberoptional
Top 5 brands' click share in the niche market (current)
Example: 1
top5BrandsClickShareT90Beforenumberoptional
Top 5 brands' click share in the niche market (90 days ago)
Example: 1
top5BrandsClickShareT360Beforenumberoptional
Top 5 brands' click share in the niche market (360 days ago)
Example: 1
top5BrandsClickShareT360Nownumberoptional
Top 5 brands' click share in the niche market (360-day stats) (current)
Example: 1
top5BrandsClickShareT360T90Beforenumberoptional
Top 5 brands' click share in the niche market (360-day stats) (90 days ago)
Example: 1
top5BrandsClickShareT360T360Beforenumberoptional
Top 5 brands' click share in the niche market (360-day stats) (360 days ago)
Example: 1
top20BrandsClickShareNownumberoptional
Top 20 brands' click share in the niche market (current)
Example: 1
top20BrandsClickShareT90Beforenumberoptional
Top 20 brands' click share in the niche market (90 days ago)
Example: 1
top20BrandsClickShareT360Beforenumberoptional
Top 20 brands' click share in the niche market (360 days ago)
Example: 1
top20BrandsClickShareT360Nownumberoptional
Top 20 brands' click share in the niche market (360-day stats) (current)
Example: 1
top20BrandsClickShareT360T90Beforenumberoptional
Top 20 brands' click share in the niche market (360-day stats) (90 days ago)
Example: 1
top20BrandsClickShareT360T360Beforenumberoptional
Top 20 brands' click share in the niche market (360-day stats) (360 days ago)
Example: 1
newProductsLaunchedSemiannualintegeroptional
Number of new products launched (semi-annual data)
Example: 1
newProductsLaunchedT180Nowintegeroptional
Number of new products launched (180-day stats) (current)
Example: 1
newProductsLaunchedT180T90Beforeintegeroptional
Number of new products launched (180-day stats) (90 days ago)
Example: 1
newProductsLaunchedT180T360Beforeintegeroptional
Number of new products launched (180-day stats) (360 days ago)
Example: 1
newProductsLaunchedT360Nowintegeroptional
Number of newly listed products (360-day stats) (current)
Example: 1
newProductsLaunchedT360T90Beforeintegeroptional
Number of newly listed products (360-day stats) (90 days ago)
Example: 1
newProductsLaunchedT360T360Beforeintegeroptional
Number of newly listed products (360-day stats) (360 days ago)
Example: 1
successfulLaunchedSemiannualintegeroptional
Number of successfully launched products (semi-annual data)
Example: 1
launchRateSemiannualnumberoptional
Product launch success rate (semi-annual data)
Example: 1
successfulLaunchesT90Nowintegeroptional
Successfully launched count (90-day stats) (current)
Example: 1
successfulLaunchesT90T90Beforeintegeroptional
Successfully launched count (90-day stats) (90 days ago)
Example: 1
successfulLaunchesT90T360Beforeintegeroptional
Successfully launched count (90-day stats) (360 days ago)
Example: 1
successfulLaunchesT180Nowintegeroptional
Number of successfully launched products (180-day stats) (current)
Example: 1
successfulLaunchesT180T90Beforeintegeroptional
Number of successfully launched products (180-day stats) (90 days ago)
Example: 1
successfulLaunchesT180T360Beforeintegeroptional
Number of successfully launched products (180-day stats) (360 days ago)
Example: 1
successfulLaunchesT360Nowintegeroptional
Number of successfully launched products (360-day stats) (current)
Example: 1
successfulLaunchesT360T90Beforeintegeroptional
Number of successfully launched products (360-day stats) (90 days ago)
Example: 1
successfulLaunchesT360T360Beforeintegeroptional
Number of successfully launched products (360-day stats) (360 days ago)
Example: 1
avgOOSRateNownumberoptional
Average out-of-stock rate (current)
Example: 1
avgOOSRateT90Beforenumberoptional
Average out-of-stock rate (90 days ago)
Example: 1
avgOOSRateT360Beforenumberoptional
Average out-of-stock rate (360 days ago)
Example: 1
avgOOSRateT360Nownumberoptional
Average out-of-stock rate (360-day stats) (current)
Example: 1
avgOOSRateT360T90Beforenumberoptional
Average out-of-stock rate (360-day stats) (90 days ago)
Example: 1
avgOOSRateT360T360Beforenumberoptional
Average out-of-stock rate (360-day stats) (360 days ago)
Example: 1
primeProductsPercentageNownumberoptional
Prime product percentage (current)
Example: 1
primeProductsPercentageT90Beforenumberoptional
Prime product percentage (90 days ago)
Example: 1
primeProductsPercentageT360Beforenumberoptional
Prime product percentage (360 days ago)
Example: 1
primeProductsPercentageT360Nownumberoptional
Prime product percentage (360-day stats) (current)
Example: 1
primeProductsPercentageT360T90Beforenumberoptional
Prime product percentage (360-day stats) (90 days ago)
Example: 1
primeProductsPercentageT360T360Beforenumberoptional
Prime product percentage (360-day stats) (360 days ago)
Example: 1
avgReviewRatingNownumberoptional
Average review rating (current)
Example: 1
avgReviewRatingT90Beforenumberoptional
Average review rating (90 days ago)
Example: 1
avgReviewRatingT360Beforenumberoptional
Average review rating (360 days ago)
Example: 1
avgReviewCountNownumberoptional
Average review count (current)
Example: 1
avgReviewCountT90Beforenumberoptional
Average review count (90 days ago)
Example: 1
avgReviewCountT360Beforenumberoptional
Average review count (360 days ago)
Example: 1
positiveCustomerReviewInsightsarrayoptional
Positive customer review insights
Example: []
negativeCustomerReviewInsightsarrayoptional
Negative customer review insights
Example: []
productStarRatingImpactarrayoptional
Product star rating impact information
Example: []
avgBrandAgeNownumberoptional
Average brand age (current)
Example: 1
avgBrandAgeT90Beforenumberoptional
Average brand age (90 days ago)
Example: 1
avgBrandAgeT360Beforenumberoptional
Average brand age (360 days ago)
Example: 1
avgBrandAgeQuarterlynumberoptional
Average brand age (quarterly data)
Example: 1
avgBrandAgeT360Nownumberoptional
Average brand age (360-day stats) (current)
Example: 1
avgBrandAgeT360T90Beforenumberoptional
Average brand age (360-day stats) (90 days ago)
Example: 1
avgBrandAgeT360T360Beforenumberoptional
Average brand age (360-day stats) (360 days ago)
Example: 1
avgSellingPartnerAgeNownumberoptional
Average selling partner age (current)
Example: 1
avgSellingPartnerAgeT90Beforenumberoptional
Average selling partner age (90 days ago)
Example: 1
avgSellingPartnerAgeT360Beforenumberoptional
Average selling partner age (360 days ago)
Example: 1
avgBestSellerRankNownumberoptional
Average Best Seller rank (current)
Example: 1
avgBestSellerRankT90Beforenumberoptional
Average Best Seller rank (90 days ago)
Example: 1
avgBestSellerRankT360Beforenumberoptional
Average Best Seller rank (360 days ago)
Example: 1
acosnumberoptional
(ACOS) Advertising Cost of Sale
Example: 1
sponsoredProductsPercentageNownumberoptional
Percentage of products with Sponsored Products ads (current)
Example: 1
sponsoredProductsPercentageT90Beforenumberoptional
Percentage of products with Sponsored Products ads (90 days ago)
Example: 1
sponsoredProductsPercentageT360Beforenumberoptional
Percentage of products with Sponsored Products ads (360 days ago)
Example: 1
sponsoredProductsPercentageT360Nownumberoptional
Percentage of products with Sponsored Products ads (360-day stats) (current)
Example: 1
sponsoredProductsPercentageT360T90Beforenumberoptional
Percentage of products with Sponsored Products ads (360-day stats) (90 days ago)
Example: 1
sponsoredProductsPercentageT360T360Beforenumberoptional
Percentage of products with Sponsored Products ads (360-day stats) (360 days ago)
Example: 1
profitMarginGt50PctSkuRationumberoptional
Proportion of products with profit margin > 50%
Example: 1
breakEvenRationumberoptional
Break-even ratio
Example: 1
returnRateAnnualnumberoptional
Return rate (annual data)
Example: 1
cpcobjectoptional
CPC (Cost Per Click) data
Example: {}
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.
titlestringoptional
Provider-specific response title.
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": [],
  "columns": [],
  "costToken": 1,
  "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0",
  "referenceAsinImageUrl": "B072MQ5BRX",
  "marketplaceId": "US",
  "demand": 1,
  "categorieList": [],
  "productCount": 1,
  "productCountNow": 1,
  "productCountT90Before": 1,
  "productCountT360Before": 1,
  "brandCount": 1,
  "brandCountNow": 1,
  "brandCountT90Before": 1,
  "brandCountT360Before": 1,
  "brandCountT360Now": 1,
  "brandCountT360T90Before": 1,
  "brandCountT360T360Before": 1,
  "sellingPartnerCountNow": 1,
  "sellingPartnerCountT90Before": 1,
  "sellingPartnerCountT360Before": 1,
  "sellingPartnerCountT360Now": 1,
  "sellingPartnerCountT360T90Before": 1,
  "sellingPartnerCountT360T360Before": 1,
  "avgPrice": 1,
  "avgProductPriceNow": 1,
  "avgProductPriceT90Before": 1,
  "avgProductPriceT360Before": 1,
  "minimumPrice": 1,
  "maximumPrice": 1,
  "searchVolumeWeekly": 1,
  "searchVolumeQuarterly": 1,
  "searchVolumeGrowthWeekly": 1,
  "searchVolumeGrowthQuarterly": 1,
  "searchConversionRateWeekly": 1,
  "searchConversionRateQuarterly": 1,
  "clickCountWeekly": 1,
  "clickCountQuarterly": 1,
  "clickConversionRateQuarterly": 1,
  "clickToSaleConversionWeekly": 1,
  "unitsSoldWeekly": 1,
  "unitsSoldQuarterly": 1,
  "top5ProductsClickShare": 1,
  "top5ProductsClickShareNow": 1,
  "top5ProductsClickShareT90Before": 1,
  "top5ProductsClickShareT360Before": 1,
  "top5ProductsClickShareT360Now": 1,
  "top5ProductsClickShareT360T90Before": 1,
  "top5ProductsClickShareT360T360Before": 1,
  "top20ProductsClickShareNow": 1,
  "top20ProductsClickShareT90Before": 1,
  "top20ProductsClickShareT360Before": 1,
  "top20ProductsClickShareT360Now": 1,
  "top20ProductsClickShareT360T90Before": 1,
  "top20ProductsClickShareT360T360Before": 1,
  "top5BrandsClickShare": 1,
  "top5BrandsClickShareNow": 1,
  "top5BrandsClickShareT90Before": 1,
  "top5BrandsClickShareT360Before": 1,
  "top5BrandsClickShareT360Now": 1,
  "top5BrandsClickShareT360T90Before": 1,
  "top5BrandsClickShareT360T360Before": 1,
  "top20BrandsClickShareNow": 1,
  "top20BrandsClickShareT90Before": 1,
  "top20BrandsClickShareT360Before": 1,
  "top20BrandsClickShareT360Now": 1,
  "top20BrandsClickShareT360T90Before": 1,
  "top20BrandsClickShareT360T360Before": 1,
  "newProductsLaunchedSemiannual": 1,
  "newProductsLaunchedT180Now": 1,
  "newProductsLaunchedT180T90Before": 1,
  "newProductsLaunchedT180T360Before": 1,
  "newProductsLaunchedT360Now": 1,
  "newProductsLaunchedT360T90Before": 1,
  "newProductsLaunchedT360T360Before": 1,
  "successfulLaunchedSemiannual": 1,
  "launchRateSemiannual": 1,
  "successfulLaunchesT90Now": 1,
  "successfulLaunchesT90T90Before": 1,
  "successfulLaunchesT90T360Before": 1,
  "successfulLaunchesT180Now": 1,
  "successfulLaunchesT180T90Before": 1,
  "successfulLaunchesT180T360Before": 1,
  "successfulLaunchesT360Now": 1,
  "successfulLaunchesT360T90Before": 1,
  "successfulLaunchesT360T360Before": 1,
  "avgOOSRateNow": 1,
  "avgOOSRateT90Before": 1,
  "avgOOSRateT360Before": 1,
  "avgOOSRateT360Now": 1,
  "avgOOSRateT360T90Before": 1,
  "avgOOSRateT360T360Before": 1,
  "primeProductsPercentageNow": 1,
  "primeProductsPercentageT90Before": 1,
  "primeProductsPercentageT360Before": 1,
  "primeProductsPercentageT360Now": 1,
  "primeProductsPercentageT360T90Before": 1,
  "primeProductsPercentageT360T360Before": 1,
  "avgReviewRatingNow": 1,
  "avgReviewRatingT90Before": 1,
  "avgReviewRatingT360Before": 1,
  "avgReviewCountNow": 1,
  "avgReviewCountT90Before": 1,
  "avgReviewCountT360Before": 1,
  "positiveCustomerReviewInsights": [],
  "negativeCustomerReviewInsights": [],
  "productStarRatingImpact": [],
  "avgBrandAgeNow": 1,
  "avgBrandAgeT90Before": 1,
  "avgBrandAgeT360Before": 1,
  "avgBrandAgeQuarterly": 1,
  "avgBrandAgeT360Now": 1,
  "avgBrandAgeT360T90Before": 1,
  "avgBrandAgeT360T360Before": 1,
  "avgSellingPartnerAgeNow": 1,
  "avgSellingPartnerAgeT90Before": 1,
  "avgSellingPartnerAgeT360Before": 1,
  "avgBestSellerRankNow": 1,
  "avgBestSellerRankT90Before": 1,
  "avgBestSellerRankT360Before": 1,
  "acos": 1,
  "sponsoredProductsPercentageNow": 1,
  "sponsoredProductsPercentageT90Before": 1,
  "sponsoredProductsPercentageT360Before": 1,
  "sponsoredProductsPercentageT360Now": 1,
  "sponsoredProductsPercentageT360T90Before": 1,
  "sponsoredProductsPercentageT360T360Before": 1,
  "profitMarginGt50PctSkuRatio": 1,
  "breakEvenRatio": 1,
  "returnRateAnnual": 1,
  "cpc": {}
}

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

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",
    "arguments": {
      "countryCode": "US",
      "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0"
    }
  }
}

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/run
MCP method
nexscope_amazon_niche_info
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-niche-info/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "countryCode": "US", "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0" }'
Response
No response yet. Run the request to see the response here.