Nexscope logo
Start free

Amazon Market Product Search 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

Multi-dimensional Amazon product search and filtering based on Sorftime data, covering 14 marketplaces, with support for historical monthly snapshot lookback.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/run
MCP method
nexscope_amazon_market_product_search

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-market-product-search/run

Run an API

Request parameters documented by ecommerce.amazon-market-product-search.

Slugamazon-market-product-search
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-market-product-search/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "queryValue": "B072MQ5BRX",   "queryType": 1,   "marketplace": "us",   "queryMode": 1,   "page": 1 }'
All categories/ Amazon Marketplace Intelligence
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/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-market-product-search/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
marketplacestringrequired
Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa
Example: us
queryModeintegeroptional
Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship)
Example: 1
queryTypeintegeroptional
Query type (1-16), only effective when queryMode=1. See the complete Query Types description in API.md
Example: 1
queryValuestringoptional
Query condition value, format varies by queryMode and queryType. See the format description for each queryType in API.md
Example: phone case
pageintegeroptional
Page number, default 1. Max 100 products per page
Example: 1
queryMonthstringoptional
Historical month lookback, format yyyy-MM. When not specified, queries real-time data
Example: 2026-01

Request example

{
  "queryValue": "B072MQ5BRX",
  "queryType": 1,
  "marketplace": "us",
  "queryMode": 1,
  "page": 1
}

Response body

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

NameTypeRequiredDescription
codeintegeroptional
Response code (200 indicates success)
Example: 1
msgstringoptional
Response message
totalintegeroptional
Total result count
Example: 1
pageintegeroptional
Current page number
Example: 1
pageCountintegeroptional
Total page count (max 200 pages)
Example: 1
costTimeintegeroptional
Latency (ms)
Example: 1
costTokenintegeroptional
Tokens consumed
Example: 1
requestConsumedintegeroptional
Requests consumed
Example: 1
typestringoptional
Render style
columnsarrayoptional
Render columns
Example: []
productsarrayoptional
Product list (see below)
Example: []
products[].asinstringoptional
ASIN
Example: B072MQ5BRX
products[].titlestringoptional
Product title
products[].brandstringoptional
Brand
products[].asinUrlstringoptional
Product link, Amazon Listing detail page URL
Example: B072MQ5BRX
products[].imageUrlstringoptional
Main image URL
Example: https://example.com/image.jpg
products[].productImageUrlsarrayoptional
Main image list (all product image URLs)
Example: []
products[].parentAsinstringoptional
Parent ASIN, the parent ASIN if variants exist, null if no variants
Example: B072MQ5BRX
products[].variationNumintegeroptional
Number of variations
Example: 1
products[].weightstringoptional
Weight, unit g
products[].sizearrayoptional
Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm
Example: []
products[].pricenumberoptional
Current price, before coupon, in local currency (e.g. USD)
Example: 1
products[].oldPricenumberoptional
Strikethrough price, in local currency (e.g. USD)
Example: 1
products[].salesPricenumberoptional
Final price, actual price after coupon deduction, in local currency (e.g. USD)
Example: 1
products[].couponintegeroptional
Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount)
Example: 1
products[].fbaFeesnumberoptional
FBA fees, in local currency (e.g. USD)
Example: 1
products[].fbaDetailarrayoptional
FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"]
Example: []
products[].platformFeenumberoptional
Platform commission, in local currency (e.g. USD)
Example: 1
products[].profitAmountnumberoptional
Profit, final price - FBA fee - commission, in local currency (e.g. USD)
Example: 1
products[].profitRatenumberoptional
Profit margin, e.g. 25.83 means 25.83%
Example: 1
products[].monthlySalesUnitsintegeroptional
Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate
Example: 1
products[].monthlySalesRevenuenumberoptional
Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate
Example: 1
products[].listingSalesVolumeOfDailyintegeroptional
Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate
Example: 1
products[].listingSalesOfDailynumberoptional
Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate
Example: 1
products[].salesRankintegeroptional
BSR rank, main category rank
Example: 1
products[].categoryarrayoptional
Main category, [category name, NodeId]
Example: []
products[].bsrCategoryarrayoptional
Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd)
Example: []
products[].ratingnumberoptional
Current rating (0.0-5.0, e.g. 4.8)
Example: 1
products[].ratingsintegeroptional
Number of ratings
Example: 1
products[].availableDatestringoptional
Listing time, format yyyy-MM-dd
Example: 2026-01-01
products[].onlineDaysintegeroptional
Days since listing
Example: 1
products[].buyboxSellerstringoptional
Buybox seller name
products[].buyBoxSellerIdstringoptional
Buybox seller ID
Example: example-id
products[].buyboxSellerAddressstringoptional
Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own
products[].isFBAbooleanoptional
Whether FBA, whether Buybox seller uses FBA logistics
Example: false
products[].sellerNumintegeroptional
Number of sellers
Example: 1
products[].aPlusbooleanoptional
Has A+
Example: false
products[].hasVideobooleanoptional
Has video
Example: false
products[].hasBrandStorebooleanoptional
Has brand store
Example: false
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
messagestringoptional
Provider-specific message.
titlestringoptional
Provider-specific response title.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
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.

{
  "code": 1,
  "total": 1,
  "page": 1,
  "pageCount": 1,
  "costTime": 1,
  "costToken": 1,
  "requestConsumed": 1,
  "columns": [],
  "products": [
    {
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "parentAsin": "B072MQ5BRX",
      "variationNum": 1,
      "size": [],
      "price": 1,
      "oldPrice": 1,
      "salesPrice": 1,
      "coupon": 1,
      "fbaFees": 1,
      "fbaDetail": [],
      "platformFee": 1,
      "profitAmount": 1,
      "profitRate": 1,
      "monthlySalesUnits": 1,
      "monthlySalesRevenue": 1,
      "listingSalesVolumeOfDaily": 1,
      "listingSalesOfDaily": 1,
      "salesRank": 1,
      "category": [],
      "bsrCategory": [],
      "rating": 1,
      "ratings": 1,
      "availableDate": "2026-01-01",
      "onlineDays": 1,
      "buyBoxSellerId": "example-id",
      "isFBA": false,
      "sellerNum": 1,
      "aPlus": false,
      "hasVideo": false,
      "hasBrandStore": false
    }
  ]
}

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 Alexa Search

Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context.

Amazon Asin Traffic Summary

Use SIF (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons.

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.

Amazon Competitor Lookup

Use SellerSprite data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends.

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_market_product_search",
    "arguments": {
      "queryValue": "B072MQ5BRX",
      "queryType": 1,
      "marketplace": "us",
      "queryMode": 1,
      "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-market-product-search/run
MCP method
nexscope_amazon_market_product_search
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "queryValue": "B072MQ5BRX", "queryType": 1, "marketplace": "us", "queryMode": 1, "page": 1 }'
Response
No response yet. Run the request to see the response here.