Nexscope logo
Start free

Amazon Product History 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

Retrieve Amazon product details by ASIN, including price, title, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history.

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

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-product-history/run

Run an API

Request parameters documented by ecommerce.amazon-product-history.

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

Request body

NameTypeRequiredDescription
asinstringrequired
Amazon Standard Identification Number (ASIN), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376
Example: B072MQ5BRX
domainstringrequired
Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)
Example: 1
historyintegeroptional
Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0
Example: 1

Request example

{
  "history": 1,
  "asin": "B072MQ5BRX",
  "domain": "1"
}

Response body

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

NameTypeRequiredDescription
totalintegeroptional
Total rows
Example: 1
perPageintegeroptional
Items per page
Example: 1
sourceTypestringoptional
Source type: keepa
columnsarrayoptional
Rendered columns
Example: []
costTokenintegeroptional
Token consumption
Example: 1
totalCountintegeroptional
Total count
Example: 1
currentPageintegeroptional
Current page number
Example: 1
typestringoptional
Render style
productsarrayoptional
Product list (see below)
Example: []
products[].asinstringoptional
ASIN
Example: B072MQ5BRX
products[].titlestringoptional
Product title
products[].brandstringoptional
Brand
products[].manufacturerstringoptional
Manufacturer
products[].modelstringoptional
Model
products[].colorstringoptional
Color
products[].materialstringoptional
Product material, the primary material used in its construction
products[].pricenumberoptional
Current price (in local currency, e.g., USD/EUR)
Example: 1
products[].primePricenumberoptional
Prime price
Example: 1
products[].currencystringoptional
Currency
products[].ratingnumberoptional
Current rating (0.0-5.0, e.g., 4.5 stars)
Example: 1
products[].ratingsintegeroptional
Number of ratings
Example: 1
products[].reviewCountintegeroptional
Number of reviews
Example: 1
products[].salesRankintegeroptional
Sales rank
Example: 1
products[].salesRank30integeroptional
Average sales rank in last 30 days
Example: 1
products[].salesRank90integeroptional
Average sales rank in last 90 days
Example: 1
products[].salesRank180integeroptional
Average sales rank in last 180 days
Example: 1
products[].monthlySalesUnitsintegeroptional
Monthly sales units
Example: 1
products[].monthlySalesRevenuenumberoptional
Monthly sales revenue
Example: 1
products[].monthlySalesUnits1MonthAgointegeroptional
Monthly sales 1 month ago
Example: 1
products[].monthlySalesUnits2MonthsAgointegeroptional
Monthly sales 2 months ago
Example: 1
products[].monthlySalesUnits3MonthsAgointegeroptional
Monthly sales 3 months ago
Example: 1
products[].monthlySalesUnits4MonthsAgointegeroptional
Monthly sales 4 months ago
Example: 1
products[].monthlySalesUnits5MonthsAgointegeroptional
Monthly sales 5 months ago
Example: 1
products[].monthlySalesUnits6MonthsAgointegeroptional
Monthly sales 6 months ago
Example: 1
products[].monthlySalesUnits7MonthsAgointegeroptional
Monthly sales 7 months ago
Example: 1
products[].monthlySalesUnits8MonthsAgointegeroptional
Monthly sales 8 months ago
Example: 1
products[].monthlySalesUnits9MonthsAgointegeroptional
Monthly sales 9 months ago
Example: 1
products[].monthlySalesUnits10MonthsAgointegeroptional
Monthly sales 10 months ago
Example: 1
products[].monthlySalesUnits11MonthsAgointegeroptional
Monthly sales 11 months ago
Example: 1
products[].monthlySalesUnits12MonthsAgointegeroptional
Monthly sales 12 months ago
Example: 1
products[].availableDatestringoptional
Listing time (yyyy-MM-dd HH:mm:ss)
Example: 2026-01-01
products[].lastUpdatestringoptional
Last update time (yyyy-MM-dd HH:mm:ss)
Example: 2026-01-01
products[].imageUrlstringoptional
Image URL (request address)
Example: https://example.com/image.jpg
products[].productImageUrlsarrayoptional
Product image list
Example: []
products[].asinUrlstringoptional
Amazon ASIN detail page URL
Example: B072MQ5BRX
products[].urlSlugstringoptional
URL slug
Example: https://example.com/image.jpg
products[].itemLengthintegeroptional
Item length in millimeters, 0 or -1 if unavailable
Example: 1
products[].itemWidthintegeroptional
Item width in millimeters, 0 or -1 if unavailable
Example: 1
products[].itemHeightintegeroptional
Item height in millimeters, 0 or -1 if unavailable
Example: 1
products[].dimensionstringoptional
Dimensions
products[].dimensionsTypestringoptional
Dimensions type
products[].weightstringoptional
Weight (grams)
products[].packageLengthintegeroptional
Package length (mm)
Example: 1
products[].packageWidthintegeroptional
Package width (mm)
Example: 1
products[].packageHeightintegeroptional
Package height (mm)
Example: 1
products[].packageWeightstringoptional
Package weight (grams)
products[].packageDimensionsstringoptional
Package dimensions
products[].packageQuantityintegeroptional
Quantity of items in the package, 0 or -1 if unavailable
Example: 1
products[].fulfillmentstringoptional
Fulfillment method (AMZ, FBA, FBM)
products[].fbaFeesnumberoptional
FBA fulfillment fee (in local currency)
Example: 1
products[].referralFeePercentagenumberoptional
Referral fee percentage
Example: 1
products[].profitnumberoptional
Profit margin (percentage, e.g., 25.5 means 25.5%)
Example: 1
products[].buyBoxSellerIdstringoptional
Buy Box seller ID
Example: example-id
products[].sellerNumintegeroptional
Number of sellers
Example: 1
products[].variationNumintegeroptional
Number of variations
Example: 1
products[].parentAsinstringoptional
Parent ASIN
Example: B072MQ5BRX
products[].rootCategoryintegeroptional
Root category ID
Example: 1
products[].categoryTreestringoptional
Category tree
products[].categoryTreeIdstringoptional
Category tree ID
Example: example-id
products[].subcategoriesarrayoptional
Subcategory list, each element contains code (category ID), rank (ranking), label (category name)
Example: []
products[].isAdultProductbooleanoptional
Whether it is an adult product
Example: false
products[].isHazmatbooleanoptional
Whether it is hazardous material
Example: false
products[].sourceTypestringoptional
Source type: keepa
products[].sourceToolstringoptional
Source tool
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
codestringoptional
Provider-specific status code.
msgstringoptional
Provider-specific status message.
messagestringoptional
Provider-specific message.
titlestringoptional
Provider-specific response title.
sourceToolstringoptional
Provider-specific source tool name.
costTimeintegeroptional
Execution time reported by the upstream provider.
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.

{
  "total": 1,
  "perPage": 1,
  "columns": [],
  "costToken": 1,
  "totalCount": 1,
  "currentPage": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "price": 1,
      "primePrice": 1,
      "rating": 1,
      "ratings": 1,
      "reviewCount": 1,
      "salesRank": 1,
      "salesRank30": 1,
      "salesRank90": 1,
      "salesRank180": 1,
      "monthlySalesUnits": 1,
      "monthlySalesRevenue": 1,
      "monthlySalesUnits1MonthAgo": 1,
      "monthlySalesUnits2MonthsAgo": 1,
      "monthlySalesUnits3MonthsAgo": 1,
      "monthlySalesUnits4MonthsAgo": 1,
      "monthlySalesUnits5MonthsAgo": 1,
      "monthlySalesUnits6MonthsAgo": 1,
      "monthlySalesUnits7MonthsAgo": 1,
      "monthlySalesUnits8MonthsAgo": 1,
      "monthlySalesUnits9MonthsAgo": 1,
      "monthlySalesUnits10MonthsAgo": 1,
      "monthlySalesUnits11MonthsAgo": 1,
      "monthlySalesUnits12MonthsAgo": 1,
      "availableDate": "2026-01-01",
      "lastUpdate": "2026-01-01",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "asinUrl": "B072MQ5BRX",
      "urlSlug": "https://example.com/image.jpg",
      "itemLength": 1,
      "itemWidth": 1,
      "itemHeight": 1,
      "packageLength": 1,
      "packageWidth": 1,
      "packageHeight": 1,
      "packageQuantity": 1,
      "fbaFees": 1,
      "referralFeePercentage": 1,
      "profit": 1,
      "buyBoxSellerId": "example-id",
      "sellerNum": 1,
      "variationNum": 1,
      "parentAsin": "B072MQ5BRX",
      "rootCategory": 1,
      "categoryTreeId": "example-id",
      "subcategories": [],
      "isAdultProduct": false,
      "isHazmat": 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_product_history",
    "arguments": {
      "history": 1,
      "asin": "B072MQ5BRX",
      "domain": "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-product-history/run
MCP method
nexscope_amazon_product_history
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-history/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "history": 1, "asin": "B072MQ5BRX", "domain": "1" }'
Response
No response yet. Run the request to see the response here.