Nexscope logo
Start free

Amazon Market Product Detail 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 Amazon product detail and historical trends by ASIN using Sorftime data, covering 14 marketplaces.

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

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

Run an API

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

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

Request body

NameTypeRequiredDescription
asinstringrequired
Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ
Example: B072MQ5BRX
marketplacestringrequired
Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa
Example: us
includeTrendintegeroptional
Whether to include trend data. 1: include (default); 2: exclude
Example: 1
queryTrendStartDatestringoptional
Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost
Example: 2026-01-01
queryTrendEndDatestringoptional
Trend end date, format yyyy-MM-dd
Example: 2026-01-15

Request example

{
  "includeTrend": 1,
  "asin": "B072MQ5BRX",
  "marketplace": "us",
  "queryTrendEndDate": "2026-01-15",
  "queryTrendStartDate": "2026-01-01"
}

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
costTimeintegeroptional
Latency (ms)
Example: 1
costTokenintegeroptional
Tokens consumed
Example: 1
requestConsumedintegeroptional
Requests consumed
Example: 1
sourceTypestringoptional
Source type: sorftime
typestringoptional
Render style
columnsarrayoptional
Render columns
Example: []
productsarrayoptional
Product detail 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[].ebcPhotoarrayoptional
A+ image list
Example: []
products[].storeNamestringoptional
Store name
products[].descriptionstringoptional
Five bullet points
products[].productBadgearrayoptional
Product badges, e.g. Amazon Choice, Best Seller, New Release, etc.
Example: []
products[].lastUpdatestringoptional
Update time, most recent ASIN data collection time (format yyyy-MM-dd)
Example: 2026-01-01
products[].offSalebooleanoptional
Whether delisted. true = unavailable, false = available
Example: false
products[].productTypestringoptional
Category, Amazon product category node name
products[].weightstringoptional
Weight, unit g
products[].sizearrayoptional
Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm
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[].variationASINarrayoptional
Child ASIN list, empty if no variants
Example: []
products[].attributearrayoptional
Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value)
Example: []
products[].pricenumberoptional
Selling 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[].platformFeenumberoptional
Platform commission, in local currency (e.g. USD)
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[].shipCostnumberoptional
FBM shipping cost, in local currency (e.g. USD)
Example: 1
products[].shipsFromstringoptional
Ship-from location
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
Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable
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[].availableDatestringoptional
Listing time, format yyyy-MM-dd
Example: 2026-01-01
products[].onlineDaysintegeroptional
Days since listing
Example: 1
products[].ratingnumberoptional
Current rating (0.0-5.0, e.g. 4.70)
Example: 1
products[].ratingsintegeroptional
Number of ratings
Example: 1
products[].fiveStarRatingsnumberoptional
5-star percentage, e.g. 57.7 means 57.7%
Example: 1
products[].fourStarRatingsnumberoptional
4-star percentage
Example: 1
products[].threeStarRatingsnumberoptional
3-star percentage
Example: 1
products[].twoStarRatingsnumberoptional
2-star percentage
Example: 1
products[].oneStarRatingsnumberoptional
1-star percentage
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
products[].featureobjectoptional
Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {"Battery life":4.0}
Example: {}
products[].productInfoobjectoptional
Product information, structured data from the Product Information section in the Listing
Example: {}
products[].propertyobjectoptional
Attribute list, including variant attributes and Bullet Points header descriptions
Example: {}
products[].brandPromotionstringoptional
Brand promotion
products[].dealTypestringoptional
Deal label
products[].extraSavingsarrayoptional
Associated promotions, e.g. [{Asin:xxx, Text:"Save 5%..."}]
Example: []
products[].rankTrendarrayoptional
BSR trend, main category rank change history, interleaved format [date, rank, ...]
Example: []
products[].bsrRankTrendarrayoptional
Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}]
Example: []
products[].listingSalesVolumeOfDailyTrendarrayoptional
Daily sales volume trend, value -1 means unable to estimate
Example: []
products[].listingSalesOfDailyTrendarrayoptional
Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate
Example: []
products[].listingSalesVolumeOfMonthTrendarrayoptional
Monthly sales volume trend (last 30 days), value -1 means unable to estimate
Example: []
products[].listingSalesOfMonthTrendarrayoptional
Monthly sales revenue trend, in local currency smallest unit (e.g. cents)
Example: []
products[].priceTrendarrayoptional
Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day
Example: []
products[].listPriceTrendarrayoptional
Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day
Example: []
products[].dealTrendarrayoptional
Deal trend, value 1 = has deal, 0 = no deal
Example: []
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.
sourceToolstringoptional
Provider-specific source tool name.
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.

{
  "code": 1,
  "total": 1,
  "costTime": 1,
  "costToken": 1,
  "requestConsumed": 1,
  "columns": [],
  "products": [
    {
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "ebcPhoto": [],
      "productBadge": [],
      "lastUpdate": "2026-01-01",
      "offSale": false,
      "size": [],
      "parentAsin": "B072MQ5BRX",
      "variationNum": 1,
      "variationASIN": [],
      "attribute": [],
      "price": 1,
      "coupon": 1,
      "platformFee": 1,
      "fbaFees": 1,
      "fbaDetail": [],
      "shipCost": 1,
      "profitAmount": 1,
      "profitRate": 1,
      "monthlySalesUnits": 1,
      "salesRank": 1,
      "category": [],
      "bsrCategory": [],
      "availableDate": "2026-01-01",
      "onlineDays": 1,
      "rating": 1,
      "ratings": 1,
      "fiveStarRatings": 1,
      "fourStarRatings": 1,
      "threeStarRatings": 1,
      "twoStarRatings": 1,
      "oneStarRatings": 1,
      "buyBoxSellerId": "example-id",
      "isFBA": false,
      "sellerNum": 1,
      "aPlus": false,
      "hasVideo": false,
      "hasBrandStore": false,
      "feature": {},
      "productInfo": {},
      "property": {},
      "extraSavings": [],
      "rankTrend": [],
      "bsrRankTrend": [],
      "listingSalesVolumeOfDailyTrend": [],
      "listingSalesOfDailyTrend": [],
      "listingSalesVolumeOfMonthTrend": [],
      "listingSalesOfMonthTrend": [],
      "priceTrend": [],
      "listPriceTrend": [],
      "dealTrend": []
    }
  ]
}

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_detail",
    "arguments": {
      "includeTrend": 1,
      "asin": "B072MQ5BRX",
      "marketplace": "us",
      "queryTrendEndDate": "2026-01-15",
      "queryTrendStartDate": "2026-01-01"
    }
  }
}

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-detail/run
MCP method
nexscope_amazon_market_product_detail
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-detail/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "includeTrend": 1, "asin": "B072MQ5BRX", "marketplace": "us", "queryTrendEndDate": "2026-01-15", "queryTrendStartDate": "2026-01-01" }'
Response
No response yet. Run the request to see the response here.