/google-shopping-reviews

Returns reviews from Google product based on a given search query (or many queries).

↗ Open in API Explorer
GET

Google Shopping Reviews

Returns reviews from Google product based on a given search query (or many queries).

Request

Endpoint: GET https://api.outscraper.cloud/google-shopping-reviews

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query array<string> Yes Product links or product IDs (e.g., https://www.google.com/shopping/product/7016166685587850095, 7016166685587850095). 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. - -
perQuery query integer No The parameter specifies the limit of items to return from one query. - default 100
uule query string No Google UULE parameter is used to encode a place or an exact location (with latitude and longitude) into a code. By using it you can see a Google result page like someone located at the specified location. - -
language query string enum No The parameter specifies the language to use for website. - default en, allowed en, de, es, es-419, fr, hr, it, nl, …
region query string enum No The parameter specifies the country to use for website. It's recommended to use it for a better search experience. - allowed AF, AL, DZ, AS, AD, AO, AI, AG, …
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": "7016166685587850095",
        "product_name": "Apple iPhone 13 - 128 GB - Blue",
        "rating": 1,
        "title": "Came from XR, Not happy with the 13",
        "body": "My last few iPhones have lasted me a long time, I bought a 13 after almost 4 years with my XR (iPhone 10). With a good amount of time between purchases I normally see a big difference/improvement in many areas upon getting a new iphone. Not this time. Camera is supposed to be much higher quality - I can&#39;t get it to focus without having to manually switch a setting and even then the XR photos would focus better and show more detail in the photo. It sounds much worse than the XR did - on a call the sound quality is noticeably poorer than my XR. The style of the phone is reminiscent of an iPhone 4, boxy and small, fit is not as comfortable in my hand width wise as the XR (normal size XR) was. I&#39;m seeing no noticeable difference in operating speed and battery life which are supposed to be improved, does not appear to be any different for me over the XR. In all I wish I had taken my XR to a repair shop to confirm it was not able to be fixed instead of shelling out almost $900 for a new iPhone that in my opinion is a down grade from the XR three models prior! Note that NOT included in the box is the plug required to charge this phone, and no headphones. The lightening cord from a newer previous iPhone will work if your going from iPhone to iPhone but if you are new to an apple phone I guess Apple expects you to spend $900 for a phone and not even provide you with what you need to charge it! I&#39;ve never been disappointed with an iPhone purchase before (iPhone4, iPhone5, iPhone6, iPhoneXR) but I am now. Apple drastically lowered the bar on the standards of an apple product with the iPhone 13 (and it appears on the iPhone 12 as well from the reviews I&#39;m reading on them). I wish I hadn&#39;t been in a pinch causing me to make this purchase without researching first, mistake on my part.",
        "source": "vzw.com",
        "source_link": "http://verizonwireless.ugc.bazaarvoice.com/6543-en_us/dev16720001/review/215375582/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
        "author": "JMPF",
        "id": "3286903277271191692",
        "date": "March 7, 2022",
        "timestamp": 1646611200
      },
      {
        "query": "7016166685587850095",
        "product_name": "Apple iPhone 13 - 128 GB - Blue",
        "rating": 3,
        "title": "Headache for $1100 lol",
        "body": "I’m giving a three star review because the phone is still usable. <br><br>I purchased the iPhone 13 Pro Max. <br><br>I really wanted to say this is a straight up five star review but it&#39;s sadly not. In terms of build quality, they can have a billion stars. I think the build quality and the physical hardware is great and lives up to the expectation. <br><br>in terms of software, this feels like five steps backwards. When this phone came out with iOS 15 out the gate, I’m telling you right now, I got a solid three days of battery life on Heavy usage - in between charges, which I’ve never gotten out of anything I’ve ever tried. The software interface itself was super smooth and almost heavenly. The buttery smooth 120 Hz refresh rate is probably one of my favorite specs about this other than battery life. <br><br>Honestly, I massively regret forgetting to turn off automatic updates. Every update since iOS 15, my phone is a glitchy mess. Siri doesn’t like responding most of the time, phone calls drop or no one can hear me and I can&#39;t hear them, Bluetooth doesn’t like acknowledging any of my previously paired devices (i came from iPhone 11), even after removing them entirely and repairing them all over again. Screen share, airplay etc and whatever else doesn’t like to cooperate often. This phone just doesn’t feel like a smart phone anymore, after these last couple of software updates. <br><br>And I&#39;m really mad that I don&#39;t get 3 days on a charge anymore. I get maybe 2 full days. <br><br>I really hope that future updates fix this and bring back the glorious feeling the very first version of iOS 15 gave.",
        "source": "Google",
        "source_link": "",
        "author": "Tom Niz",
        "id": "-3598031973281430307",
        "date": "November 30, 2021",
        "timestamp": 1638230400
      },
      {
        "query": "7016166685587850095",
        "product_name": "Apple iPhone 13 - 128 GB - Blue",
        "rating": 5,
        "title": "Amazing phone but…",
        "body": "Most Notable changes from iPhone 12 to iPhone 13:<br><br>-Thicker/Heavier: 174g, previously 164g<br>-A15 Chip: previously A14 Chip<br>-Battery: 3240 mAh, previously 2815 mAh<br>-Brightness: 800 nits, previously 625 nits<br>-Storage: 128/256/512GB, previously 64/128/256GB<br>-Cameras: New/bigger sensors allow for more light capture/detail, New Photographic Styles and Cinematic Video effects.<br><br>The camera notch at the top is also noticeably smaller on the iPhone 13.<br><br>Opinions so far:<br>This iPhone 13 seems very similar to the iPhone 12. After using it for a few days, I can&#39;t say that there is anything dramatically different about this version compared to the iPhone 12. It feels slightly heavier, the screen is a bit brighter, the cameras seem to do a slightly better job in low light situations (sometimes), and it can shoot Cinematic Video, although I&#39;ve had mixed results with that feature. The new chip should be faster, and the bigger battery should last slightly longer; but I haven&#39;t really noticed much of a difference in either of those categories with my daily use so far.<br><br>I can&#39;t really see a compelling reason to upgrade from the iPhone 12 at the moment. If you are looking for a more noticeable upgrade, you might want to check out the Pro versions, as the iPhone 13 Pro and Pro Max have 120 Hz refresh rate screens that really stand out to me; and combined with the better cameras and extra GPU in the Pros, those might be worth the extra cost to you.",
        "source": "Best Buy",
        "source_link": "http://reviews.bestbuy.com/3545/6443178/review/274417300/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
        "author": "AnhHo",
        "id": "3504233510729422616",
        "date": "January 9, 2022",
        "timestamp": 1641686400
      }
    ]
  ]
}

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"
}

204

application/json

The request was finished with failure and has no results.

{
  "id": "your-request-id",
  "status": "Failure"
}

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/google-shopping-reviews?query=7016166685587850095&async=false" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/google-shopping-reviews?query=7016166685587850095" -H  "X-API-KEY: YOUR-API-KEY"

Related Endpoints