/amazon-reviews

Returns product's reviews from Amazon.

↗ Open in API Explorer
GET

Amazon Reviews

Returns product's reviews from Amazon.

Request

Endpoint: GET https://api.outscraper.cloud/amazon-reviews

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query array<string> Yes You can use URLs or ASINs from Amazon products (e.g., https://www.amazon.com/dp/1612680194, 1612680194, etc.). It supports batching by sending arrays with up to 1000 queries (e.g., query=text1&query=text2&query=text3). It allows multiple queries to be sent in one request and to save on network latency time. - -
limit query integer No The parameter specifies the limit of reviews to get from one query. Maximum is 12. - default 10
domain query string enum No The parameter specifies Amazon domain to use. - default amazon.com, allowed amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.es, amazon.fr, amazon.it, amazon.in, …
fields query string No The parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields. Use &fields=query,name to return only the specific ones. - -
async query boolean Yes The parameter defines the way you want to submit your task to Outscraper. It can be set to false to open an HTTP connection and keep it open until you got your results, or true (default) to just submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes) with the Request Results endpoint. Each response is available for 4 hours after a request has been completed. A good practice is to send async requests and start checking the results after the estimated execution time. Check out this Python implementation as an example. As most of the requests take some time to be executed the async=true option is preferred to avoid HTTP requests timeouts. - default true
ui query boolean No The parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async parameter to true. - default false
format query array<string enum> No The parameter defines the format of the output data. Using this parameter overwrites the ui parameter to true. - -
webhook query string No The parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations. - -

Responses

200

application/json

The response contains the status of the request and data. Data is an array where each element represents a response for a single query from the request.

{
  "id": "your-request-id",
  "status": "Success",
  "data": [
    [
      {
        "query": "https://www.amazon.com/dp/1612680194",
        "id": "R2VYT9ETWPTAWU",
        "product_asin": "1612680194",
        "title": "Everything",
        "body": "I read this book about 11 years ago at 27 years old , had no money, I followed the advice in this book and now have 15 rental properties paid off free and clear, my assets more than cover all my expenses. I just bought this book again, I'm in the middle of reading it again now 11 years later and can't put it down.  I hate reading btw.  I plan on reading this book at least three more times over the next 20 years so I can keep all info fresh in my mind. People always ask me about success. I tell them to read this book...whats crazy is that they don't read it. You can lead a horse to water but can't make it drink. The book changed my life and it will change yours. Do you want change or do you just want to talk and think about change? There is a big difference , do it.",
        "rating": 5,
        "rating_text": "5.0 out of 5 stars",
        "helpful": "1,331 people found this helpful",
        "comments": null,
        "date": "Reviewed in the United States on March 17, 2018",
        "bage": "Verified Purchase",
        "official_comment_banner": "",
        "url": "https://www.amazon.com/gp/customer-reviews/R2VYT9ETWPTAWU/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194",
        "img_url": null,
        "variation": "",
        "total_reviews": 65459,
        "overall_rating": 4.7,
        "author_title": "Ilive4him24",
        "author_descriptor": "",
        "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGQCR5JZP3V6Y743KX3UYJBRRVOA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
        "author_profile_img": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars/default._CR0,0,1024,1024_SX48_.png",
        "product_url": "https://www.amazon.com/dp/1612680194"
      },
      {
        "query": "https://www.amazon.com/dp/1612680194",
        "id": "R1T9953QMMGUEX",
        "product_asin": "1612680194",
        "title": "Make sure you Select the Book Size",
        "body": "I owned this book in the past and wanted to reorder it to read it again.  Instead of getting the book I expected, I received a tiny, hand sized book, with print that is too small and that is, frankly, hard to open all the way in order to read the words near the binder.  So the book is utterly useless. With all the complaints about this tiny book, I'm not sure why that is the book that automatically comes up when you search for the book.  Instead, the normal sized book should be the default, and then people can select the pocket sized book if they want. So I would say that the content of the book is excellent. DO purchase the book; however, BE SURE TO SELECT THE LARGER, PAPERBACK VERSION if that's what you want (sorry for the all caps, just want to make sure people see that part).",
        "rating": 1,
        "rating_text": "1.0 out of 5 stars",
        "helpful": "851 people found this helpful",
        "comments": null,
        "date": "Reviewed in the United States on January 23, 2018",
        "bage": "Verified Purchase",
        "official_comment_banner": "",
        "url": "https://www.amazon.com/gp/customer-reviews/R1T9953QMMGUEX/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194",
        "img_url": null,
        "variation": "",
        "total_reviews": 65459,
        "overall_rating": 4.7,
        "author_title": "judysardenspeaker",
        "author_descriptor": "",
        "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHBNQFY6SXYTRVWW7RUKDYY4RBBA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
        "author_profile_img": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
        "product_url": "https://www.amazon.com/dp/1612680194"
      },
      {
        "query": "https://www.amazon.com/dp/1612680194",
        "id": "RIGBUZ8E2S6UT",
        "product_asin": "1612680194",
        "title": "A great foundation book for beginning to improve your financial intelligence",
        "body": "This is an enhanced reprint of the original, with additional study questions/ discussion and review added at the end of every chapter. I bought the original about 18 years ago and it changed my families destiny for the better. I am glad the reprint came out as it prompted me to reread it and deepen my understanding. Some people complain that this book does not give a step by step process for change. I would counter that one size shoe does not fit all feet. There are many individual paths to wealth, and Kiyosaki sets the guiding stars to navigate by, but you have to walk your own individual road. Some key concepts of this book are: 1) Assets put money in your pocket even when you are on vacation. Liabilities take money out of your pocket, therefore your house is a liability [unless you rent out rooms and the garage as one person I know did while rebuilding his asset base]. 2) Wealthy people buy assets first, and then let their assets buy their luxuries from the surplus cash flow. 3) Wealthy people continuously increase their assets by reinvesting their surplus cash flow in more assets. 4) There are 3 primary asset classes: Real Estate, Businesses, and Paper assets (stocks bonds notes, etc) 5) Cash Flow is more important than Net Worth. Net Worth is similar to potential energy, to use it you have to spend it, then it is gone. Cash Flow is like power from a hydroelectric dam, constantly replenished. The rich don't work for money, they work for assets. The tax laws are fair from the standpoint that the laws that the rich spent billions of dollars to have modified and interpreted apply to everyone who learns how to use them. A great foundation book for beginning to improve your financial intelligence so that you don't work 4 or more month's of every year for the Tax man, more months for the banks that hold your mortgage and credit cards, and whatever is left making the company you work for wealthy. Good luck on your journey to being Rich, poor, or middle class.",
        "rating": 4,
        "rating_text": "4.0 out of 5 stars",
        "helpful": "1,186 people found this helpful",
        "comments": null,
        "date": "Reviewed in the United States on June 19, 2017",
        "bage": "Verified Purchase",
        "official_comment_banner": "",
        "url": "https://www.amazon.com/gp/customer-reviews/RIGBUZ8E2S6UT/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194",
        "img_url": null,
        "variation": "",
        "total_reviews": 65459,
        "overall_rating": 4.7,
        "author_title": "Eugene C.",
        "author_descriptor": "",
        "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGUEMAJSJVAUZR2OUSFBBNJM3KQQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
        "author_profile_img": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
        "product_url": "https://www.amazon.com/dp/1612680194"
      }
    ]
  ]
}

202

application/json

The response contains a request ID that can be used to fetch results by using Request Results endpoint. Each response is available for 4 hours after a request has been completed.

{
  "id": "your-request-id",
  "status": "Pending",
  "results_location": "https://api.outscraper.cloud/requests/your-request-id"
}

401

application/json

Wrong or missing API Key (token).

{
  "error": true,
  "errorMessage": "401 Unauthorized: The server could not verify that you are authorized to access the URL requested. You either supplied the wrong credentials (e.g. a bad password), or your browser doesn't understand how to supply the credentials required."
}

402

application/json

Past due invoices or a payment method not connected.

{
  "error": true,
  "errorMessage": "Please close past due invoices or verify your card information is correct."
}

422

application/json

Wrong query url parameters.

{
  "error": true,
  "errorMessage": "422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors."
}

Code Samples

cURL

curl -X GET "https://api.outscraper.cloud/amazon-reviews?query=https://www.amazon.com/dp/1612680194&limit=3&async=false" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/amazon-reviews?query=https://www.amazon.com/dp/1612680194&limit=3" -H  "X-API-KEY: YOUR-API-KEY"

Python

from outscraper import OutscraperClient

api_client = OutscraperClient(api_key='YOUR-API-KEY')
results = api_client.amazon_reviews('https://www.amazon.com/dp/B00G3XWLR8', limit=3)

Related Endpoints