Amazon API endpoint
Returns product details for an Amazon ASIN on `amazon.com`, including pricing, availability, overview data, inline review samples, and descriptive content.
/amazon/product/{asin}Path parameters:
asin: required. Amazon ASIN. Example: B0DGJ736JM.Query parameters:
language: optional. Amazon language. Default: en_US. Allowed values: en_US.currency: optional. Amazon currency. Default: USD. Allowed values: USD.| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| label | 8 | “value for money” and 7 other values |
| summary | 8 | median 114 characters |
| mentions | 8 | 7 to 31, median 10 |
| mention_percent | 8 | 50 to 100, median 90 |
| sentiment | 8 | positive (7), mixed (1) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| asin (path) | string | Yes | Amazon ASIN | B0DGJ736JM | |
| language | string | No | Amazon language Allowed values: en_US. | ||
| currency | string | No | Amazon currency Allowed values: USD. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/amazon/product/B0DGJ736JM?language=en¤cy=USD" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"asin": "B0DGJ736JM",
"title": "Apple Watch SE (2nd Gen) [GPS 40mm]",
"link": "https://www.amazon.com/dp/B0DGJ736JM/",
"rating": 4.4,
"review_count": 1055,
"price": 189
}
}Request schema
No body schema
Response schema
#/definitions/amazon.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | amazon.Product | No | ||||
| data.about | string | No | Text of the product's feature bullet points ("About this item"). | |||
| data.asin | string | No | B0DGJ736JM | Amazon Standard Identification Number (ASIN) of the product. | ||
| data.availability | boolean | No | true | True when the product page shows the item as in stock. | ||
| data.brand_link | string | No | https://www.amazon.com/stores/Apple/page/77D9E1F7-0337-4282-9DB6-B6B8FB2DC98D | URL of the brand's store page on Amazon. Omitted when the page shows none. | ||
| data.brand_name | string | No | Apple Store | Brand name shown on the product page. Omitted when the page shows none. | ||
| data.customers_say | string | No | Summary of what customers say about the product, from the "Customers say" section. | |||
| data.description | string | No | Product description text, converted to Markdown. | |||
| data.images | array | No | URLs of the product's gallery images. | |||
| data.is_free_delivery | boolean | No | true | True when the product page offers free delivery. | ||
| data.is_free_return | boolean | No | true | True when the product page offers free returns. | ||
| data.link | string | No | https://www.amazon.com/dp/B0DGJ736JM/ | URL of the product page on Amazon. | ||
| data.low_confidence | boolean | No | false | LowConfidence is true when the rating widget failed to parse (rating=0 alongside a nonzero review count) on every hedge attempt, so the result is handed back unfiltered rather than discarded, but flagged as untrusted and never cached as fresh. | ||
| data.number_of_bought_in_last_month | integer | No | 1000 | Number of units bought in the past month, as shown on the page (for example 1000 for "1K+ bought"). Zero when the page shows none. | ||
| data.overview | object | No | Key product facts from the overview table, as pairs of label and value. | |||
| data.price | number | No | 189 | Current price of the product, in US dollars. | ||
| data.rating | number | No | 4.4 | Average customer rating, out of 5. | ||
| data.rating_hist | object | No | Share of ratings for each star level, keyed by stars from `1` to `5`, with values from 0 to 1. | |||
| data.review_count | integer | No | 1055 | Total number of customer ratings shown on the page. | ||
| data.review_images | array | No | Customer-uploaded photos from the reviews section. | |||
| data.review_images[].review_id | string | No | R31YRHYX7G6DNK | Id of the review the photo belongs to. Omitted when not shown. | ||
| data.review_images[].thumbnail | string | No | https://m.media-amazon.com/images/I/example._SY250_.jpg | URL of a smaller version of the photo. Omitted when not shown. | ||
| data.review_images[].url | string | No | https://m.media-amazon.com/images/I/example.jpg | URL of the full-size photo. | ||
| data.review_insights | array | No | Topics customers mention most often in reviews, each with a sentiment. | |||
| data.review_insights[].label | string | No | quality | Topic customers mention, for example `quality`. | ||
| data.review_insights[].mention_percent | integer | No | 98 | Whole-number percentage Amazon reports alongside the topic's mention count. | ||
| data.review_insights[].mentions | integer | No | 41 | Number of reviews that mention the topic. | ||
| data.review_insights[].sentiment | string | No | positive | Overall sentiment of the mentions, for example `positive`. | ||
| data.review_insights[].summary | string | No | Customers like the build quality. | Short summary of what customers say about the topic. | ||
| data.reviews | array | No | Customer review samples shown on the product page. | |||
| data.reviews[].content | string | No | Text of the review. | |||
| data.reviews[].country | string | No | United States | Country the review was written in, as shown in "Reviewed in ...". | ||
| data.reviews[].helpful_count | integer | No | 4 | Number of people who found the review helpful. Omitted when none are shown. | ||
| data.reviews[].link | string | No | URL of the review on Amazon. | |||
| data.reviews[].rating | number | No | 4 | Star rating the reviewer gave, out of 5. | ||
| data.reviews[].review_date | string | No | Date the review was posted, in RFC 3339 format. | |||
| data.reviews[].title | string | No | Headline of the review. | |||
| data.reviews[].user_link | string | No | URL of the reviewer's profile on Amazon. | |||
| data.reviews[].user_name | string | No | Display name of the reviewer. | |||
| data.reviews[].verified_purchase | boolean | No | true | True when the review carries the Verified Purchase badge. | ||
| data.seller_link | string | No | https://www.amazon.com/b?node=10158976011 | URL of the seller's page on Amazon. | ||
| data.seller_name | string | No | Amazon Resale | Name of the seller offering the product. | ||
| data.title | string | No | Apple Watch SE (2nd Gen) [GPS 40mm] Smartwatch with Midnight Aluminium Case with Midnight Sport Band S/M. Fitness and Sleep Trackers, Crash Detection, Heart Rate Monitor, Retina Display | Product title as shown on the Amazon product page. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/amazon/product/B0DGJ736JM?language=en¤cy=USD" \
-H "x-api-key: $CRAWLORA_API_KEY"