Amazon

Amazon Broad Product Search

Use SellerSprite data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces.

MCP tool name

nexscope_amazon_broad_product_search

MCP endpoint

https://api.nexscope.ai/api/skill-api/v2/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.

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

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-broad-product-search

Progress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it 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
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.total`	`integer`	optional	Total matching product count Example: 1
`data.products`	`array`	optional	Product list (see product object fields below) Example: []
`data.products[]`	`object`	required	Item in data products.
`data.products[].nodeIdPath`	`string`	optional

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "total": 1,
    "products": [
      {
        "asin": "B072MQ5BRX",
        "asinUrl": "B072MQ5BRX",
        "imageUrl": "https://example.com/image.jpg",
        "price": 1,
        "averagePrice": 1,
        "primePrice": 1,
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "monthlySalesUnitsGrowthRate": 1,
        "bsr": 1,
        "bsrGrowthRate": 1,
        "rating": 1,
        "ratings": 1,
        "ratingsRate": 1,
        "profit": 1,
        "fba": 1,
        "sellerNum": 1,
        "sellerId": "example-id",
        "brandUrl": "https://example.com/image.jpg",
        "availableDate": "2026-01-01",
        "availableDateString": "2026-01-01",
        "variationNum": 1,
        "variant30DayUnits": 1,
        "variant30DayRevenue": 1,
        "variant30DayUpdatedAt": "2026-01-01",
        "listingQualityScore": 1,
        "deliveryPrice": 1,
        "nodeId": 1,
        "badge": {},
        "subcategories": [],
        "keyword": "phone case"
      }
    ],
    "columns": [],
    "keyword": "phone case",
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Amazon Broad Product Search

Amazon Broad Product Search

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 2