Amazon reviews API documentation
We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:
- The Amazon API returns 10 reviews per request.
- The order in which reviews are returned is by descending date(from newest to oldest).
- You can get all reviews from a single place by using the
offset
parameter.
To get reviews from Wextractor you will need to perform GET
requests against
the https://wextractor.com/api/v1/reviews/amazon
endpoint.
Reviews endpoint parameters:
Parameter | Required | Description | Example |
---|---|---|---|
auth_token | Required | Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. | - |
id | Required | A textual identifier that uniquely identifies a product in Amazon. This identifier is an identifier that appears in the url for the product in amazon. For example, if the url for the product in amazon is https://www.amazon.com/All-new-Kindle-Oasis-now-with-adjustable-warm-light/dp/B07F7TLZF4/ the identifier is B07F7TLZF4
|
B07F7TLZF4 |
country | Optional | The country code for the Amazon site. By default the API returns results from https://amazon.com.
The supported countries are: us (United States), ca (Canada), au (Australia) and uk (United Kingdom).
|
us |
offset | Optional | This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). | 10 |
Example usage:
https://wextractor.com/api/v1/reviews/amazon?id=B07F7TLZF4&country=us&auth_token=XXXXX&offset=0
Example response:
{
"reviews": [
{
"id": "R2NEVNR2PHPSMT",
"text": "I love the reader, but have experienced multiple technical problems, particularly when trying to download a new book.",
"url": "https://www.amazon.com/gp/customer-reviews/R2NEVNR2PHPSMT?ASIN=B07F7TLZF4",
"title": "Great Reader, But Too Many Technical Problems",
"reviewer": "John K",
"rating": "3.0",
"datetime": "2022-06-02T00:00:00"
},
{
"id": "R385VLDE9CEXIX",
"text": "The waterproofing was the primary reason I picked this model and it works as advertised. The battery life is great and it holds a lot of books. The WIFI is archaic, I have nothing that can connect to it wirelessly. The built-in light works well, but it's either too blue or yellow for my taste. I think the touch screen software needs tweaking, e.g. attempting to highlight a single word will net a sentence more often than not, then you have to wait for the system delay or your highlight will move unpredictably, then you can adjust the highlight (it shouldn't take more than two or three attempts). I primarily use the buttons to flip pages because sometimes the touchscreen isn't very intuitive, e.g. touching the right side of the screen to advance doesn't always work, will go back a page (or more), or will activate the menu - all of which can be a bit disorienting. The Oasis runs slow compared to modern devices, so if you're a fast reader, keep large libraries of books, or are just impatient you might be better off using the app. After scrolling through 10 \"pages\" of my library I give up and go online to see what books I want to revisit or to find the unread books lost in the shuffle. There's a lot of unused space around the buttons and on the backside an awkward hump. The Oasis would have been better served if that awkward hump was better distributed and the device made narrower for more ways to handle it while reading and for ease of transporting. Outside of these quirks, I've enjoyed using it but there's a lot of room for improvement.",
"url": "https://www.amazon.com/gp/customer-reviews/R385VLDE9CEXIX?ASIN=B07F7TLZF4",
"title": "A lot of room for improvement with an archaic WIFI",
"reviewer": "JC",
"rating": "3.0",
"datetime": "2022-06-02T00:00:00"
},
{
"id": "R1L5QNM94KZ59T",
"text": "Everything is good except for the longevity of the product. This is my 3rd Kindle and each one only lasted about 2-3 years.😕",
"url": "https://www.amazon.com/gp/customer-reviews/R1L5QNM94KZ59T?ASIN=B07F7TLZF4",
"title": "Poor quality!",
"reviewer": "Raquell",
"rating": "5.0",
"datetime": "2022-06-01T00:00:00"
},
{
"id": "R1XCQNA3SRWOZK",
"text": "I have found i can read this Oasis while walking on my treadmill and therefore, I walk much more often and longer than I would otherwise. However, I have difficulty when leaving one book and returning to the library.",
"url": "https://www.amazon.com/gp/customer-reviews/R1XCQNA3SRWOZK?ASIN=B07F7TLZF4",
"title": "Easy to read while walking on treadmill.",
"reviewer": "dixiegal",
"rating": "4.0",
"datetime": "2022-05-29T00:00:00"
},
{
"id": "RSJKFTHS4JLF0",
"text": "I’ve had my Oasis for over 2 years now, and I still love it. My biggest issue with this Kindle, though, has always been the battery life. It’s horrible, and if you’re reading for a few hours, multiple times a day, the Oasis won’t even get you through a full charge. And that’s with airplane being on and the brightness adjusted low. The fact the Oasis battery is advertised as lasting weeks on a single charge is completely untrue. You might be charging it 3 times a week, if you’re an avid reader. I never had this problem with my Paperwhite.",
"url": "https://www.amazon.com/gp/customer-reviews/RSJKFTHS4JLF0?ASIN=B07F7TLZF4",
"title": "Great Kindle, Terrible Battery Life",
"reviewer": "Victoria M. ",
"rating": "4.0",
"datetime": "2022-05-28T00:00:00"
},
{
"id": "R1W82X6FPYYHS9",
"text": "It is square> Your can never get it out of your pocket. Get rectangular ones.",
"url": "https://www.amazon.com/gp/customer-reviews/R1W82X6FPYYHS9?ASIN=B07F7TLZF4",
"title": "Never but this Kindle",
"reviewer": "Christopher Truss",
"rating": "1.0",
"datetime": "2022-05-28T00:00:00"
},
{
"id": "R1UBB6NJTF9JKX",
"text": "I've been using Kindle E-readers for about a decade. I've had everything from the most basic, no backlight version, to the Kindle Keyboard 3G, to the Paperwhite to, now, owning the Oasis. The screen is wonderful, the device itself is beautifully crafted. Having physical turn page buttons is kind of a big deal for me (though the touch screen is plenty responsive). Whether or not you need one of these over the far more affordable Paperwhite (which in itself is excellent) depends on how much money you want to spend. The reading experience will be just as good on the Paperwhite. But if you want nothing but the finer things in life, the Oasis is that.",
"url": "https://www.amazon.com/gp/customer-reviews/R1UBB6NJTF9JKX?ASIN=B07F7TLZF4",
"title": "Unquestionably the best Kindle ever.",
"reviewer": "Nerd Ferguson",
"rating": "5.0",
"datetime": "2022-05-27T00:00:00"
},
{
"id": "R3DK45R90VYDTB",
"text": "I’ll start by saying this is so fast, screen quality is great, light is wonderful but everything good about this is more than offset by how horrible the battery is. I have the latest firmware and never use backlight in more than 10-12 and I get a mere 2 days out of it (6 hours of reading). It will lose 10% overnight while not being used too. The battery is just so so bad, I’m glad this was gifted to me because I would be so angry had I spent my own money to upgrade from my Voyage to this. I would not recommend buying this at all.",
"url": "https://www.amazon.com/gp/customer-reviews/R3DK45R90VYDTB?ASIN=B07F7TLZF4",
"title": "Amazing except the battery",
"reviewer": "Brian",
"rating": "1.0",
"datetime": "2022-05-25T00:00:00"
},
{
"id": "R29F13E5G1I33L",
"text": "Otherwise wonderful product is virtually unusable after 18 months. Battery lasts only a few hours, regardless of settings. I should never have \"upgraded\" from my Paperwhite. Most unhappy I've been with an Amazon product.",
"url": "https://www.amazon.com/gp/customer-reviews/R29F13E5G1I33L?ASIN=B07F7TLZF4",
"title": "Battery issues make it unusable after 18 months",
"reviewer": "Steve B",
"rating": "1.0",
"datetime": "2022-05-25T00:00:00"
},
{
"id": "R33IM8KKH1AMES",
"text": "I'm a Kindle addict. When a new model was released, I would buy it. The Oasis is my favorite Kindle, and it would take a lot to get me to change. I'm no longer fickle. The Oasis is worth the extra money because it has some awesome features. I owned the original Oasis, but I had a problem that was exacerbated by me. I purchased another Oasis. To me, this is a perfect reader. It is very lightweight, fits in one hand, easy to navigate, holds about 324 books and the battery is better than any other Kindle I have had. If you are vacillating - don't Shilly Shally.",
"url": "https://www.amazon.com/gp/customer-reviews/R33IM8KKH1AMES?ASIN=B07F7TLZF4",
"title": "Oasis Kindle",
"reviewer": "Roberto1",
"rating": "5.0",
"datetime": "2022-05-24T00:00:00"
}
],
"totals": {
"average_rating": "4.6",
"review_count": 4629
}
}
Frequently asked questions:
- How do I get all the reviews for a single product?
- Does the API have rate limits?
You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.
Yes, since Amazon is pretty strict at blocking requests you will be rate limited if you perform more than ten requests per second.