Nexscope

Amazon Niche Intelligence JM: get Niche Info By Keyword API

Use Amazon Niche Intelligence JM: get Niche Info By Keyword API through Nexscope with documented parameters, structured results and API key authentication.

CostRecent Avg. 18 · Range 10–19 credits / call
Try online
POST · https://api.nexscope.ai/jm/getNicheInfoByKeywordMCP · nexscope_data_jm_get_niche_info_by_keyword
Amazon Niche Intelligence JM

What this API does

Use Amazon Niche Intelligence JM: get Niche Info By Keyword API through Nexscope with documented parameters, structured results and API key authentication. The request accepts keyword, countryCode, page, pageSize, sortField. Its documented result includes title, nicheId, nicheTitle, translationZh, demand, productCount, avgPrice, minimumPrice.

Amazon Niche Intelligence JM: get Niche Info By Keyword API API use cases

Build a keyword shortlist

To build a keyword shortlist, a marketplace analyst submits keyword and countryCode to Amazon Niche Intelligence JM: get Niche Info By Keyword API. The returned title, nicheId, nicheTitle help choose candidate search terms for further investigation.

Compare search demand signals

A marketplace analyst uses Amazon Niche Intelligence JM: get Niche Info By Keyword API with keyword and countryCode to compare search demand signals. The returned title, nicheId, nicheTitle help compare keyword demand within the requested market scope.

Plan a content or advertising test

For this workflow, a marketplace analyst calls Amazon Niche Intelligence JM: get Niche Info By Keyword API with keyword and countryCode to plan a content or advertising test. The result helps select terms for a content or advertising experiment.

Amazon Niche Intelligence JM: get Niche Info By Keyword API API FAQ

What does the Amazon Niche Intelligence JM: get Niche Info By Keyword API API return?

Use Amazon Niche Intelligence JM: get Niche Info By Keyword API through Nexscope with documented parameters, structured results and API key authentication. The documented output includes title, nicheId, nicheTitle, translationZh, demand, productCount, avgPrice, minimumPrice. It corresponds to the supplied keyword, countryCode, page, pageSize, sortField. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the Amazon Niche Intelligence JM: get Niche Info By Keyword API API cost?

The current documented cost is Recent Avg. 18 · Range 10–19 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Amazon Niche Intelligence JM: get Niche Info By Keyword API API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/jm/getNicheInfoByKeyword with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_data_jm_get_niche_info_by_keyword. The same documented request parameters apply; use Online test to review a request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/jm/getNicheInfoByKeyword
MCP method
nexscope_data_jm_get_niche_info_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/jm/getNicheInfoByKeyword

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/jm/getNicheInfoByKeyword' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "countryCode": "US",
  "keyword": "wireless earbuds",
  "page": 1,
  "pageSize": 20,
  "sortField": "demand",
  "sortType": "desc"
}'

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/ Amazon Niche Intelligence JM
POSThttps://api.nexscope.ai/jm/getNicheInfoByKeyword

Run this API

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

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/jm/getNicheInfoByKeyword
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
keywordstringrequired
Keywords (required, and according to the selected country, translate the keywords into the language of the corresponding country), the maximum length is 1000 characters
countryCodestringoptional
Country code, optional values: `US` (United States), `JP` (Japan), `DE` (Germany)
Example: US
pageintegeroptional
Page number (starting from 1)
Example: 1
pageSizeintegeroptional
Number of returns per page (10-100)
Example: 50
sortFieldstringoptional
Sorting field (see sorting options below)
Example: unitsSoldT7
sortTypestringoptional
Sort by: `desc` (descending) or `asc` (ascending)
Example: desc
productCountMinintegeroptional
Product quantity (current) minimum
productCountMaxintegeroptional
Product quantity (current) maximum
avgPriceMinnumberoptional
Average price (current) minimum
avgPriceMaxnumberoptional
Average Price (Current) Maximum
searchVolumeT7Minintegeroptional
Search volume (7 days statistics) minimum value
searchVolumeT7Maxintegeroptional
Maximum search volume (7-day statistics)
unitsSoldT7Minintegeroptional
Sales volume (7 days statistics) minimum value
unitsSoldT7Maxintegeroptional
Maximum sales volume (7-day statistics)
clickCountT7Minintegeroptional
Click volume (7 days statistics) minimum value
clickCountT7Maxintegeroptional
Maximum number of clicks (7-day statistics)
clickConversionRateT7Minnumberoptional
Minimum click conversion rate (7-day statistics), the value range is 0-1, representing 0%-100%
clickConversionRateT7Maxnumberoptional
The maximum value of click conversion rate (7-day statistics), the value range is 0-1, representing 0%-100%
brandCountMinintegeroptional
Minimum number of brands
brandCountMaxintegeroptional
Maximum number of brands
top5BrandsClickShareMinnumberoptional
The minimum share of clicks in the market segment occupied by the top 5 brands. The value range is 0-1, representing 0%-100%.
top5BrandsClickShareMaxnumberoptional
The maximum share of clicks in the market segment occupied by the top 5 brands. The value range is 0-1, representing 0%-100%.
avgBrandAgeMinnumberoptional
Average brand age (current) minimum
avgBrandAgeMaxnumberoptional
Average Brand Age (Current) Max
avgBrandAgeQoqMinnumberoptional
Average brand age (90 days statistics) minimum value
avgBrandAgeQoqMaxnumberoptional
Average brand age (90 days statistics) maximum value
avgBrandAgeYoyMinnumberoptional
Average brand age (360 days statistics) minimum value
avgBrandAgeYoyMaxnumberoptional
Maximum average brand age (360 days statistics)
avgSellingPartnerAgeMinnumberoptional
Minimum average sales partner age
avgSellingPartnerAgeMaxnumberoptional
Maximum average age of sales partners
avgSellingPartnerAgeQoqMinnumberoptional
Average sales partner age (90 days statistics) minimum
avgSellingPartnerAgeQoqMaxnumberoptional
Maximum average age of sales partners (90-day statistics)
avgSellingPartnerAgeYoyMinnumberoptional
Average sales partner age (360 days statistics) minimum value
avgSellingPartnerAgeYoyMaxnumberoptional
Maximum average age of sales partners (360 days statistics)
top5ProductsClickShareMinnumberoptional
The (current) minimum click share of the top 5 products, the value range is 0-1, representing 0%-100%
top5ProductsClickShareMaxnumberoptional
The (current) maximum click share of the top 5 products, the value range is 0-1, representing 0%-100%
sponsoredProductsPercentageMinnumberoptional
The minimum SP advertising proportion, the value range is 0-1, representing 0%-100%
sponsoredProductsPercentageMaxnumberoptional
The maximum proportion of SP advertising, the value range is 0-1, representing 0%-100%
cpcMediumMinnumberoptional
CPC (current) minimum
cpcMediumMaxnumberoptional
CPC (current) maximum
launchRateT180Minnumberoptional
The minimum success rate of product release (180-day statistics), the value range is 0-1, representing 0%-100%
launchRateT180Maxnumberoptional
The maximum success rate of product release (180-day statistics), the value range is 0-1, representing 0%-100%
newProductRateT180numberoptional
The minimum value of the proportion of new products (180-day statistics), the value range is 0-1, representing 0%-100%
returnRateT360Minnumberoptional
The minimum return rate (360 days statistics), the value range is 0-1, representing 0%-100%
returnRateT360Maxnumberoptional
The maximum return rate (360 days statistics), the value range is 0-1, representing 0%-100%

Code example

{
  "countryCode": "US",
  "keyword": "wireless earbuds",
  "page": 1,
  "pageSize": 20,
  "sortField": "demand",
  "sortType": "desc"
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Response fields

Response field reference (41 fields)

NameTypeRequiredDescription
totalintegeroptional
total
dataarrayoptional
List of segment information (see segment object fields below)
columnsarrayoptional
Rendered columns
titlestringoptional
Title
typestringoptional
Rendering style
costTokenintegeroptional
Consume token
nicheIdstringoptional
Segment ID
nicheTitlestringoptional
market segment title
translationZhstringoptional
Market segment title (Chinese)
demandintegeroptional
segment score
productCountintegeroptional
Product quantity
avgPricenumberoptional
Product average price
minimumPricenumberoptional
Product lowest price
maximumPricenumberoptional
Product highest price
searchVolumeWeeklyintegeroptional
Search volume (weekly data)
searchVolumeQuarterlyintegeroptional
Search volume (quarterly data)
searchVolumeGrowthWeeklynumberoptional
Search volume growth rate (weekly data)
searchVolumeGrowthQuarterlynumberoptional
Search volume growth rate (quarterly data)
unitsSoldWeeklyintegeroptional
Sales quantity (weekly data)
unitsSoldQuarterlyintegeroptional
Sales volume (quarterly data)
clickCountWeeklyintegeroptional
Clicks (weekly data)
clickCountQuarterlyintegeroptional
Clicks (quarterly data)
clickToSaleConversionWeeklynumberoptional
Click conversion rate (weekly data)
clickConversionRateQuarterlynumberoptional
Click conversion rate (quarterly data)
searchConversionRateWeeklynumberoptional
Search conversion rate (weekly data)
searchConversionRateQuarterlynumberoptional
Search conversion rate (quarterly data)
brandCountintegeroptional
Number of brands
top5BrandsClickSharenumberoptional
Click share of market segments occupied by top 5 brands
top5ProductsClickSharenumberoptional
Click share of the top 5 products
avgBrandAgeNownumberoptional
Average brand age (current)
avgBrandAgeQuarterlynumberoptional
Average brand age (quarterly data)
newProductsLaunchedSemiannualintegeroptional
Number of new products launched (half-year data)
successfulLaunchedSemiannualintegeroptional
Number of successfully released products (half-year data)
launchRateSemiannualnumberoptional
Success rate of product release (half-year data)
returnRateAnnualnumberoptional
Return rate (full year data)
acosnumberoptional
(ACOS) Advertising Cost of Sales Ratio
profitMarginGt50PctSkuRationumberoptional
Proportion of products with profit margin greater than 50%
breakEvenRationumberoptional
Break-even natural proportion
cpcobjectoptional
CPC data: `{ high (highest price), medium (middle price), low (lowest price) }`
categorieListarrayoptional
Product category list
referenceAsinImageUrlstringoptional
Market segment reference picture address

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/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_data_jm_get_niche_info_by_keyword",
    "arguments": {
      "countryCode": "US",
      "keyword": "wireless earbuds",
      "page": 1,
      "pageSize": 20,
      "sortField": "demand",
      "sortType": "desc"
    }
  }
}

Legacy MCP v1

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

GET / POST /mcp/legacy

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

12 credits / callAPI usage records

Try it

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

Endpoint
/jm/getNicheInfoByKeyword
MCP method
nexscope_data_jm_get_niche_info_by_keyword
cURL
curl -X POST \
  https://api.nexscope.ai/jm/getNicheInfoByKeyword \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "countryCode": "US", "keyword": "wireless earbuds", "page": 1, "pageSize": 20, "sortField": "demand", "sortType": "desc" }'
Response
No response yet. Run the request to see the response here.

Related APIs