Nexscope logo

Amazon 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

Retrieve detailed Amazon product information by ASIN, including title, images, bullet points, specifications, A+ content, pricing, ratings & reviews, variants, and more.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-detail/run
MCP method
nexscope_amazon_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-product-detail/run

Run an API

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

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

Request body

NameTypeRequiredDescription
asinsstringrequired
ASIN list, supports batch query, up to 40 ASINs. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$. Example: B072MQ5BRX,B08N5WRWNW
Example: B072MQ5BRX
amazonDomainstringoptional
Amazon country site, default amazon.com. Options: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.ca, amazon.com.au, amazon.com.br, amazon.in, amazon.nl, amazon.se, amazon.pl, amazon.sg, amazon.sa, amazon.ae, amazon.com.tr, amazon.com.mx, amazon.eg, amazon.cn, amazon.com.be
languagestringoptional
Language. Examples: en_US, de_DE, fr_FR, ja_JP, it_IT, es_ES, pt_BR, en_GB, zh_CN
deliveryZipstringoptional
Delivery zip code, used to get delivery-related pricing. Examples: 10001 (New York, US), 10115 (Berlin, Germany), EC1A 1BB (London, UK)
devicestringoptional
Device type: desktop (default), mobile, tablet
returnBoughtTogetherbooleanoptional
Whether to return frequently bought together items (boughtTogether), default false
Example: false
returnRelatedProductsbooleanoptional
Whether to return related product list (relatedProducts), default false
Example: false
returnAuthorsReviewsbooleanoptional
Whether to return author review list (authorsReviews), default false
Example: false

Request example

{
  "returnAuthorsReviews": false,
  "asins": "B072MQ5BRX",
  "returnBoughtTogether": false,
  "returnRelatedProducts": false
}

Response body

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

NameTypeRequiredDescription
totalintegeroptional
Total rows
Example: 1
columnsarrayoptional
Rendered columns
Example: []
typestringoptional
Render style
costTokenintegeroptional
Token consumption
Example: 1
productsarrayoptional
Product list (see below)
Example: []
products[].asinstringoptional
ASIN code
Example: B072MQ5BRX
products[].titlestringoptional
Product title
products[].brandstringoptional
Brand
products[].pricenumberoptional
Price
Example: 1
products[].extractedPricenumberoptional
Extracted price
Example: 1
products[].oldPricenumberoptional
Original price
Example: 1
products[].extractedOldPricenumberoptional
Extracted original price
Example: 1
products[].currencystringoptional
Currency
products[].discountstringoptional
Discount
products[].saveWithCouponstringoptional
Amount saved with coupon
products[].ratingnumberoptional
Rating
Example: 1
products[].ratingsintegeroptional
Number of reviews
Example: 1
products[].primebooleanoptional
Whether it is a Prime item
Example: false
products[].stockstringoptional
Stock status
products[].deliverystringoptional
Delivery information
products[].linkstringoptional
Product link
products[].linkCleanstringoptional
Clean link
products[].asinUrlstringoptional
Link
Example: B072MQ5BRX
products[].imageUrlstringoptional
Thumbnail
Example: https://example.com/image.jpg
products[].thumbnailstringoptional
Thumbnail
products[].productImageUrlsarrayoptional
Product image URL list
Example: []
products[].aboutItemarrayoptional
Bullet points
Example: []
products[].productDescriptionstringoptional
Product description; when A+ content exists, this is a JSON string (see A+ structure below)
products[].descriptionstringoptional
Product description
products[].dimensionstringoptional
Product dimensions
products[].weightstringoptional
Weight
products[].tagsstringoptional
Tag list
products[].badgesstringoptional
Badge list
products[].climatePledgeFriendlybooleanoptional
Whether it is Climate Pledge Friendly
Example: false
products[].snapEbtEligiblebooleanoptional
Whether SNAP EBT eligible
Example: false
products[].boughtLastMonthstringoptional
Units bought last month (string)
products[].boughtLastMonthCountintegeroptional
Units bought last month (number)
Example: 1
products[].reviewsSummarystringoptional
Review summary
products[].reviewsImagesarrayoptional
Review image list
Example: []
products[].sourceToolstringoptional
Source tool
products[].sourceTypestringoptional
Source type: amazon
products[].pageFileUrlstringoptional
Full page file URL
Example: https://example.com/image.jpg
products[].manufacturerstringoptional
Manufacturer
products[].productDimensionsstringoptional
Product dimensions
products[].upcstringoptional
UPC code
products[].unitsstringoptional
Units
products[].reviewintegeroptional
Number of reviews
Example: 1
products[].fiveStarintegeroptional
Five-star review count
Example: 1
products[].fourStarintegeroptional
Four-star review count
Example: 1
products[].threeStarintegeroptional
Three-star review count
Example: 1
products[].twoStarintegeroptional
Two-star review count
Example: 1
products[].oneStarintegeroptional
One-star review count
Example: 1
products[].itemsarrayoptional
Variant item list, each item contains name (name), asin (ASIN code), position (position), selected (whether selected)
Example: []
products[].positionintegeroptional
Module order
Example: 1
products[].imagestringoptional
A+ module main image URL (often contains aplus-media-library-service-media)
Example: https://example.com/image.jpg
products[].carouselImagesarrayoptional
Optional; carousel sub-items, each containing position / title / image
Example: []
asinstringoptional
ASIN code
Example: B072MQ5BRX
titlestringoptional
Title
products[].pricestringoptional
Price
extractedPricenumberoptional
Extracted price
Example: 1
products[].priceUnitstringoptional
Unit price
extractedPriceUnitnumberoptional
Extracted unit price
Example: 1
products[].thumbnailstringoptional
Thumbnail
products[].linkstringoptional
Link
products[].linkCleanstringoptional
Clean link
products[].stockstringoptional
Stock status
deliveryarrayoptional
Delivery information
Example: []
positionintegeroptional
Position
Example: 1
products[].oldPricestringoptional
Original price
extractedOldPricenumberoptional
Extracted original price
Example: 1
ratingnumberoptional
Rating
Example: 1
reviewsintegeroptional
Number of reviews
Example: 1
primebooleanoptional
Whether it is a Prime item
Example: false
sponsoredbooleanoptional
Whether it is a sponsored item
Example: false
climatePledgeFriendlybooleanoptional
Whether Climate Pledge Friendly
Example: false
products[].discountstringoptional
Discount
badgesarrayoptional
Badge list
Example: []
products[].textstringoptional
Review content
products[].authorstringoptional
Author
authorImagestringoptional
Author avatar
Example: https://example.com/image.jpg
products[].authorLinkstringoptional
Author link
datestringoptional
Date
Example: 2026-01-01
verifiedPurchasebooleanoptional
Whether verified purchase
Example: false
products[].helpfulVotesstringoptional
Helpful vote count
products[].productSizestringoptional
Product size
products[].productFlavorNamestringoptional
Product flavor name
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.
sourceTypestringoptional
Provider-specific source platform type.
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,
  "columns": [],
  "costToken": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "price": 1,
      "extractedPrice": 1,
      "oldPrice": 1,
      "extractedOldPrice": 1,
      "rating": 1,
      "ratings": 1,
      "prime": false,
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "aboutItem": [],
      "climatePledgeFriendly": false,
      "snapEbtEligible": false,
      "boughtLastMonthCount": 1,
      "reviewsImages": [],
      "pageFileUrl": "https://example.com/image.jpg",
      "review": 1,
      "fiveStar": 1,
      "fourStar": 1,
      "threeStar": 1,
      "twoStar": 1,
      "oneStar": 1,
      "items": [],
      "position": 1,
      "image": "https://example.com/image.jpg",
      "carouselImages": []
    }
  ],
  "asin": "B072MQ5BRX",
  "extractedPrice": 1,
  "extractedPriceUnit": 1,
  "delivery": [],
  "position": 1,
  "extractedOldPrice": 1,
  "rating": 1,
  "reviews": 1,
  "prime": false,
  "sponsored": false,
  "climatePledgeFriendly": false,
  "badges": [],
  "authorImage": "https://example.com/image.jpg",
  "date": "2026-01-01",
  "verifiedPurchase": 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

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_detail",
    "arguments": {
      "returnAuthorsReviews": false,
      "asins": "B072MQ5BRX",
      "returnBoughtTogether": false,
      "returnRelatedProducts": false
    }
  }
}

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-detail/run
MCP method
nexscope_amazon_product_detail
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-detail/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "returnAuthorsReviews": false, "asins": "B072MQ5BRX", "returnBoughtTogether": false, "returnRelatedProducts": false }'
Response
No response yet. Run the request to see the response here.