Amazon Intelligence SS

Amazon Broad Product Search

Find Amazon products by sales, price, ratings, and fulfillment. Call the Amazon Broad Product Search API via REST or MCP from 21 credits per call.

MCP tool name

nexscope_amazon_broad_product_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-broad-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_broad_product_search",
    "arguments": {
      "keyword": "phone case",
      "marketplace": "US",
      "matchType": 1,
      "page": 1,
      "size": 20
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`chatId`	`string`	optional	Chat ID, maxLength 1000 Example: example-id
`uid`	`string`	optional	User ID, maxLength 1000 Example: example-id
`requestId`	`string`	optional	Push ID, maxLength 1000 Example: example-id
`teamId`	`string`	optional	Team ID, maxLength 1000 Example: example-id
`keyword`	`string`	optional	Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240 Example: phone case
`matchType`	`integer`	optional	Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match Example: 1
`excludeKeywords`	`string`	optional	Exclude keywords; maxLength 10240 Example: phone case
`marketplace`	`string`	optional	Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported) Example: US
`nodeLabel`	`string`	optional	Amazon category name; maxLength 1000 Example: {}
`nodeIdPath`	`string`	optional	Amazon category node ID; maxLength 1000 Example: {}
`filterSubNode`	`boolean`	optional	Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false Example: false
`dataSnapshotMonth`	`string`	optional	Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000 Example: {}
`minPrice`	`number`	optional	Minimum price (>= 0) Example: 1
`maxPrice`	`number`	optional	Maximum price (>= 0) Example: 1
`minProfit`	`number`	optional	Minimum gross margin, unit % (1-100) Example: 1
`maxProfit`	`number`	optional	Maximum gross margin, unit % (1-100) Example: 1
`minRevenue`	`number`	optional	Minimum monthly sales revenue (>= 0) Example: 1
`maxRevenue`	`number`	optional	Maximum monthly sales revenue (>= 0) Example: 1
`minFba`	`number`	optional	Minimum FBA shipping fee (>= 0) Example: 1
`maxFba`	`number`	optional	Maximum FBA shipping fee (>= 0) Example: 1
`minUnits`	`integer`	optional	Minimum monthly sales volume (>= 0) Example: 1
`maxUnits`	`integer`	optional	Maximum monthly sales volume (>= 0) Example: 1
`minAmzUnit`	`integer`	optional	Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a "last 30 days" type query); minimum 0 Example: 1
`maxAmzUnit`	`integer`	optional	Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0 Example: 1
`minUnitsGrowthRate`	`number`	optional	Minimum monthly sales volume growth rate, unit % Example: 1
`maxUnitsGrowthRate`	`number`	optional	Maximum monthly sales volume growth rate, unit % Example: 1
`minBsr`	`integer`	optional	Lowest main category BSR rank Example: 1
`maxBsr`	`integer`	optional	Highest main category BSR rank Example: 1
`minBsrGrowthRate`	`number`	optional	Minimum BSR growth rate, unit % Example: 1
`maxBsrGrowthRate`	`number`	optional	Maximum BSR growth rate, unit % Example: 1
`minBsrGrowthCount`	`integer`	optional	Minimum BSR growth count Example: 1
`maxBsrGrowthCount`	`integer`	optional	Maximum main category BSR growth count Example: 1
`minSubNodeBsrRank`	`integer`	optional	Lowest subcategory BSR rank (requires filterSubNode = true) Example: 1
`maxSubNodeBsrRank`	`integer`	optional	Highest subcategory BSR rank (requires filterSubNode = true) Example: 1
`minRating`	`number`	optional	Minimum rating value (0-5) Example: 1
`maxRating`	`number`	optional	Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range Example: 1
`minRatings`	`integer`	optional	Minimum review count (0-10000) Example: 1
`maxRatings`	`integer`	optional	Maximum review count (0-10000) Example: 1
`minRatingsGrowthCount`	`integer`	optional	Minimum monthly new review count (>= 0) Example: 1
`maxRatingsGrowthCount`	`integer`	optional	Maximum monthly new review count (>= 0) Example: 1
`minListingQualityScore`	`number`	optional	Minimum Listing page quality score (>= 0) Example: 1
`maxListingQualityScore`	`number`	optional	Maximum Listing page quality score (>= 0) Example: 1
`minVariations`	`integer`	optional	Minimum number of variations Example: 1
`maxVariations`	`integer`	optional	Maximum number of variations Example: 1
`minWeights`	`number`	optional	Minimum weight (>= 0) Example: 1
`maxWeights`	`number`	optional	Maximum weight (>= 0) Example: 1
`weightUnit`	`string`	optional	Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering Example: {}
`dimensionType`	`string`	optional	Package dimension type (codes vary by site, see below) Example: {}
`minSellers`	`integer`	optional	Minimum number of sellers Example: 1
`maxSellers`	`integer`	optional	Maximum number of sellers Example: 1
`badgeBestSeller`	`string`	optional	Best Seller badge filter: Y, N, or empty (all) Example: {}
`badgeAmazonsChoice`	`string`	optional	Amazon's Choice badge filter: Y, N, or empty (all) Example: {}
`badgeNewRelease`	`string`	optional	New Release badge filter: Y, N, or empty (all) Example: {}
`fulfillment`	`string`	optional	Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit Example: {}
`showVariation`	`string`	optional	Whether to query variants: Y or N, default N Example: {}
`hideUnlistedProduct`	`boolean`	optional	Whether to hide delisted products, default true Example: false
`listedWithinLastMonths`	`integer`	optional	Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers) Example: 1
`sellerNation`	`string`	optional	Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit Example: {}
`includeSellers`	`string`	optional	Include sellers; maxLength 10240 Example: {}
`excludeSellers`	`string`	optional	Exclude sellers; maxLength 10240 Example: {}
`includeBrands`	`string`	optional	Include brands; maxLength 10240 Example: {}
`excludeBrands`	`string`	optional	Exclude brands; maxLength 10240 Example: {}
`order`	`object`	optional	Sort configuration; if passed, it is recommended to provide both field and desc (both are required in the sub-schema) Example: {}
`order.field`	`string`	optional	Sort field: total_units (monthly sales), total_amount (monthly revenue), bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (variant sales). Default total_units. Pass an empty string "" to not sort by the above business fields (full query sort semantics are handled by the server) Example: {}
`order.desc`	`string`	optional	"true" descending, "false" ascending; default "true"; maxLength 1000 Example: {}
`page`	`integer`	optional	Page number, starting from 1, default 1 Example: 1
`size`	`integer`	optional	Results per page (10-100), default 20 Example: 20

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of matching products Example: {}
`products`	`array`	optional	Product list Example: {}
`columns`	`array`	optional	Rendered column definitions Example: {}
`keyword`	`string`	optional	Search keywords used (if any) Example: {}
`nodeIdPath`	`string`	optional	Search category node Example: {}
`nodeLabel`	`string`	optional	Amazon category name Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`sourceType`	`string`	optional	Source type, such as `amazon` Example: {}
`type`	`string`	optional	rendering style Example: {}
`message`	`string`	optional	Additional message or error message Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`asin`	`string`	optional	Amazon ASIN Example: {}
`title`	`string`	optional	Product title Example: {}
`asinUrl`	`string`	optional	Amazon product detail page URL Example: {}
`imageUrl`	`string`	optional	Product image URL Example: {}
`price`	`number`	optional	current price Example: {}
`averagePrice`	`number`	optional	average price Example: {}
`primePrice`	`number`	optional	Prime price, -1 means none Example: {}
`currency`	`string`	optional	Currency Example: {}
`monthlySalesUnits`	`integer`	optional	monthly sales Example: {}
`monthlySalesRevenue`	`number`	optional	monthly sales Example: {}
`monthlySalesUnitsGrowthRate`	`number`	optional	monthly sales growth rate Example: {}
`bsr`	`integer`	optional	BSR Ranking Example: {}
`bsrGrowthRate`	`number`	optional	BSR growth rate Example: {}
`rating`	`number`	optional	Rating Example: {}
`ratings`	`integer`	optional	Rating number Example: {}
`ratingsRate`	`number`	optional	Review rate Example: {}
`profit`	`number`	optional	Gross profit margin (%) Example: {}
`fba`	`number`	optional	FBA shipping Example: {}
`sellerNum`	`integer`	optional	Number of sellers Example: {}
`sellerId`	`string`	optional	BuyBox seller ID Example: {}
`sellerName`	`string`	optional	BuyBox seller name Example: {}
`sellerNation`	`string`	optional	BuyBox seller nationality Example: {}
`brand`	`string`	optional	brand Example: {}
`brandUrl`	`string`	optional	Brand page URL Example: {}
`fulfillment`	`string`	optional	Shipping method (AMZ/FBA/FBM) Example: {}
`availableDate`	`string`	optional	Release time (timestamp) Example: {}
`availableDateString`	`string`	optional	Release date (formatted string) Example: {}
`variationNum`	`integer`	optional	number of variants Example: {}
`variant30DayUnits`	`integer`	optional	Monthly sales volume of daughter bodies (number of pieces) Example: {}
`variant30DayRevenue`	`number`	optional	Subsidiary monthly sales Example: {}
`variant30DayUpdatedAt`	`string`	optional	Subbody data update time Example: {}
`weight`	`string`	optional	weight Example: {}
`packageWeight`	`string`	optional	Packing weight Example: {}
`dimension`	`string`	optional	Size Example: {}
`packageDimensions`	`string`	optional	Packing size Example: {}
`dimensionsType`	`string`	optional	size type Example: {}
`packageDimensionType`	`string`	optional	Packaging size type Example: {}
`listingQualityScore`	`number`	optional	Listing quality score Example: {}
`deliveryPrice`	`number`	optional	Seller shipping fee, -1 means none Example: {}
`nodeLabelPath`	`string`	optional	Category path Example: {}
`nodeIdPath`	`string`	optional	Node ID path Example: {}
`nodeId`	`integer`	optional	Node ID Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`badgeBestSeller`	`string`	optional	Best Seller logo (Y/N) Example: {}
`badgeAmazonChoice`	`string`	optional	Amazon's Choice logo (Y/N) Example: {}
`badgeNewRelease`	`string`	optional	New Release logo (Y/N) Example: {}
`badgeVideo`	`string`	optional	Video introduction logo (Y/N) Example: {}
`badgeEbc`	`string`	optional	A+ page identification (Y/N) Example: {}
`badge`	`object`	optional	Identity summary object, including `bestSeller`, `amazonChoice`, `newRelease`, `video`, `ebc` Example: {}
`subcategories`	`array`	optional	List of subcategories, each containing `code`, `rank`, `label` Example: {}
`sku`	`string`	optional	SKU Example: {}
`keyword`	`string`	optional	Keywords corresponding to filtering Example: {}
`sourceType`	`string`	optional	Source type Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "marketplace": "US",
  "matchType": 1,
  "page": 1,
  "size": 20
}

Example structuredContent

{}