/google-maps-reviews

Returns Google Maps reviews from places when using search queries (e.g., restaurants, Manhattan, NY, USA) or from a single place when using Google IDs or names (e.g., NoMad Restau…

↗ Open in API Explorer
GET

Google Maps Reviews

Returns Google Maps reviews from places when using search queries (e.g., restaurants, Manhattan, NY, USA) or from a single place when using Google IDs or names (e.g., NoMad Restaurant, NY, USA, 0x886916e8bc273979:0x5141fcb11460b226). In addition to the reviews, it returns places information.

In case no reviews were found by your search criteria, your search request will consume the usage of one review.

This endpoint is optimized for fast responses and can be used as a real-time API. Set the reviewsLimit parameter to 10 to achieve the maximum response speed.

Request

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

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query string Yes The parameter defines the query you want to search. You can use anything that you would use on a regular Google Maps site. Additionally, you can use google_id (feature_id), place_id, or CID. The example of valid queries: Real estate agency, Rome, Italy, The NoMad Restaurant, NY, USA, restaurants, Brooklyn 11203, 0x886916e8bc273979:0x5141fcb11460b226, ChIJrZhup4lZwokRUr_5sLoFlDw, 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 save on network latency time. You might want to check out the web application to play with locations and categories that we would suggest. Restaurants, Manhattan, NY, US -
reviewsLimit query integer No The parameter specifies the limit of reviews to get from one place (0 = unlimited). - default 100
reviewsQuery query string No The parameter specifies the query to search among the reviews (e.g. wow, amazing | great). - -
limit query integer No The parameter specifies the limit of places to take from one query search. - default 1
sort query string enum No The parameter specifies one of the sorting types. - default most_relevant, allowed most_relevant, newest, highest_rating, lowest_rating
lastPaginationId query string No The parameter specifies the review_pagination_id of the last item. Used for pagination. - -
start query integer No The parameter specifies the start timestamp value for reviews (newest review). The current timestamp is used when the value is not provided. Using the start parameter overwrites the sort parameter to newest. Therefore, the latest reviews will be at the beginning. - -
cutoff query integer No The parameter specifies the oldest timestamp value for reviews (oldest review). Using the cutoff parameter overwrites sort parameter to newest. Therefore, the latest reviews will be at the beginning. - -
cutoffRating query integer No The parameter specifies the maximum for lowest_rating sorting or the minimum for highest_rating sorting rating for reviews. Using the cutoffRating requires sorting to be set to lowest_rating or highest_rating. - -
ignoreEmpty query boolean No The parameter specifies whether to ignore reviews without text or not. - default false
source query string enum No The parameter specifies source filter. This commonly used for hotels where you can find reviews from other sources like Booking.com, Expedia, etc. - default , allowed google
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 place with its reviews.

{
  "id": "your-request-id",
  "status": "Success",
  "data": [
    {
      "name": "The NoMad Restaurant",
      "full_address": "1170 Broadway, New York, NY 10001",
      "rating": 4.7,
      "reviews": 775,
      "reviews_data": [
        {
          "google_id": "0x89c259a60b120b1d:0xec845e2f4e9ce9f0",
          "author_link": "https://www.google.com/maps/contrib/104170839246363926920?hl=en-US",
          "author_title": "Mohamed Alkhouri",
          "author_id": "104170839246363926920",
          "author_image": "https://lh3.googleusercontent.com/a-/AOh14Gia8pJbpg5di2qVBPl-TYOVq2ivAMsgkW9r5YKROFI=s120-c-c0x00000000-cc-rp-mo-ba6-br100",
          "review_text": "This one of the best restaurants in NYC. They have the best food that no one can make like it. Professional services and staff. The chf is the best cooker at all. The drinks and the soft drinks are the best. In short cut, the are all what you looking for if you are hungry or with someone you love. I don't visit the restaurant, but my brother is student there and I trust his tastes. I download the photos from the Google. Thanks to everyone and have a nice meal in the best restaurant.",
          "review_img_url": "https://lh5.googleusercontent.com/p/AF1QipMKASaZtgif3BpoPZ8zmWpOUxA8reNzG3Ukk4SW",
          "review_img_urls": [
            "https://lh5.googleusercontent.com/p/AF1QipMKASaZtgif3BpoPZ8zmWpOUxA8reNzG3Ukk4SW"
          ],
          "owner_answer": null,
          "owner_answer_timestamp": null,
          "owner_answer_timestamp_datetime_utc": null,
          "review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s104170839246363926920!2s0x0:0xec845e2f4e9ce9f0?hl=en-US",
          "review_rating": 5,
          "review_timestamp": 1616000898,
          "review_datetime_utc": "03/17/2021 17:08:18",
          "review_likes": 0,
          "reviews_id": "-1403893626557371920"
        },
        {
          "google_id": "0x89c259a60b120b1d:0xec845e2f4e9ce9f0",
          "author_link": "https://www.google.com/maps/contrib/100439884166244262419?hl=en-US",
          "author_title": "Dong Kyu Kim",
          "author_id": "100439884166244262419",
          "author_image": "https://lh3.googleusercontent.com/a-/AOh14GjkEPOWpXjbS80IEt0brUantU33gb-TwoSmznqZUbA=s120-c-c0x00000000-cc-rp-mo-ba2-br100",
          "review_text": "Great views with great heaters. I felt hot while eating even though they had a perfect outdoor setting with air flowing.\nThe food was great as well as the service.\nMy favorite part of the chicken dinner was the deviled eggs and thigh/leg part of the chicken.\nDessert was also really good!",
          "review_img_url": "https://lh5.googleusercontent.com/p/AF1QipPXomo_OkXx4XD16VyRXBCKepoZ1djXYU01yY9O",
          "review_img_urls": [
            "https://lh5.googleusercontent.com/p/AF1QipPXomo_OkXx4XD16VyRXBCKepoZ1djXYU01yY9O"
          ],
          "owner_answer": null,
          "owner_answer_timestamp": null,
          "owner_answer_timestamp_datetime_utc": null,
          "review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s100439884166244262419!2s0x0:0xec845e2f4e9ce9f0?hl=en-US",
          "review_rating": 5,
          "review_timestamp": 1611152718,
          "review_datetime_utc": "01/20/2021 14:25:18",
          "review_likes": 1,
          "reviews_id": "-1403893626557371920"
        },
        {
          "google_id": "0x89c259a60b120b1d:0xec845e2f4e9ce9f0",
          "author_link": "https://www.google.com/maps/contrib/105269840870997446655?hl=en-US",
          "author_title": "Roseanne Whiteley",
          "author_id": "105269840870997446655",
          "author_image": "https://lh3.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4=s120-c-c0x00000000-cc-rp-mo-br100",
          "review_text": "I'm going to this restaurant for the third time, and I've always been pleased with the service they offer. The service was excellent, polite, competent, and knowledgeable. We had a sense of sincere concern from the workers. They were really professional and polite as well. Many thanks! Your restaurant should be strongly recommended! Cheer for your win!",
          "review_img_url": "https://lh3.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4",
          "review_img_urls": [
            "https://lh5.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4"
          ],
          "owner_answer": null,
          "owner_answer_timestamp": null,
          "owner_answer_timestamp_datetime_utc": null,
          "review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s105269840870997446655!2s0x0:0xec845e2f4e9ce9f0?hl=en-US",
          "review_rating": 5,
          "review_timestamp": 1615839713,
          "review_datetime_utc": "03/15/2021 20:21:53",
          "review_likes": 0,
          "reviews_id": "-1403893626557371920"
        }
      ],
      "google_id": "0x89c259a60b120b1d:0xec845e2f4e9ce9f0",
      "place_id": "ChIJHQsSC6ZZwokR8OmcTi9ehOw",
      "reviews_link": "https://search.google.com/local/reviews?placeid=ChIJHQsSC6ZZwokR8OmcTi9ehOw&q=The+NoMad+Restaurant,+NY,+USA&authuser=0&hl=en&gl=US",
      "reviews_id": "-1403893626557371920",
      "reviews_per_score": {
        "1": 9,
        "2": 9,
        "3": 38,
        "4": 124,
        "5": 595
      },
      "location_link": "https://www.google.com/maps/place/The+NoMad+Restaurant/@40.7449586,-73.9884885,14z/data=!4m8!1m2!2m1!1sThe+NoMad+Restaurant!3m4!1s0x89c259a60b120b1d:0xec845e2f4e9ce9f0!8m2!3d40.7449586!4d-73.9884885"
    }
  ]
}

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-maps-reviews?query=The%20NoMad%20Restaurant,%20NY,%20USA&reviewsLimit=3&async=false" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/google-maps-reviews?query=The%20NoMad%20Restaurant,%20NY,%20USA&reviewsLimit=3" -H  "X-API-KEY: YOUR-API-KEY"

Python

from outscraper import OutscraperClient

api_client = OutscraperClient(api_key='YOUR-API-KEY')
results = api_client.google_maps_reviews('The NoMad Restaurant, NY, USA', reviews_limit=3)

Related Endpoints