1. Home
  2. Docs
  3. API Docs
  4. Google reviews API

Google reviews API

Endpoint allows you to extract organizations reviews from Google Maps.

GET: https://api.app.outscraper.com/maps/reviews

Request parameters

apiKey (required)

API token from the profile page.

query (required)

Parameter defines the query you want to search. You can use anything that you would use in a regular Google Maps search. It supports batching by sending arrays with up to 50 items (?query=Cecconi's Dumbo Brooklyn&query=Restaurant Tim Raue Berlin).

sort

(default: most_relevant) –¬†Parameter specifies one of the sorting types: most_relevant, newest, highest_rating or lowest_rating.

language

(default: en) – Parameter specifies the language to use for Google Maps site.

region

(default: us) – Parameter specifies the country to use for Google Maps site.

organizationsPerQueryLimit

(default: 1) – Parameter specifies the limit of organizations to take from one query search.

reviewsPerOrganizationLimit

(default: 100) – Parameter specifies the limit of reviews to extract from one organization.

async

(default: true) Parameter defines the way you want to submit your search to OutScraper. It can be set to false to open an HTTP connection and keep it open until you got your search results, or true (default) to just submit your search to OutScraper and retrieve them later (usually a few seconds). In this case, you’ll need to use Requests Archive to retrieve your results.


Example request async:
https://api.app.outscraper.com/maps/reviews?apiKey=SECRET_API_KEY&query=Cecconi%20Dumbo%20Brooklyn

Example response async:
{"status":"Pending","id":"32692d16-725c-4e66-b013-95e80e873b7e"}

Example request:
https://api.app.outscraper.com/maps/reviews?apiKey=SECRET_API_KEY&query=real%20estate%20agency,%20berlin&organizationsPerQueryLimit=20&reviewsPerOrganizationLimit=10&async=false

Example response:
{
  "status": "Success", 
  "id": "1dfe551c-9a7a-4f88-82c6-b4c5410111e5", 
  "data": [
    {
      "name": "Next Estate GmbH", 
      "address": "Kollwitzstra\u00dfe 38, 10405 Berlin, \u041d\u0456\u043c\u0435\u0447\u0447\u0438\u043d\u0430", 
      "address_street": "Kollwitzstra\u00dfe 38", 
      "address_borough": "Pankow", 
      "address_city": "Berlin", 
      "time_zone": "Europe/Berlin", 
      "type": "\u0420\u0456\u0435\u043b\u0442\u0435\u0440", 
      "types": "\u0420\u0456\u0435\u043b\u0442\u0435\u0440, \u0410\u0433\u0435\u043d\u0442\u0441\u0442\u0432\u043e \u0437 \u043d\u0435\u0440\u0443\u0445\u043e\u043c\u043e\u0441\u0442\u0456", 
      "postal_code": "10405", 
      "latitude": 52.5337393, 
      "longitude": 13.4154784, 
      "phone": "+49 30 40301000", 
      "rating": 4.6, 
      "reviews": 42, 
      "site": "https://www.next-estate.de/", 
      "photos_count": 31, 
      "google_id": "0x47a84e025f326e25:0x110d888e0e856f71", 
      "reviews_link": "https://www.google.com/search?q=Next+Estate+GmbH,+Kollwitzstra%C3%9Fe+38,+10405+Berlin,+%D0%9D%D1%96%D0%BC%D0%B5%D1%87%D1%87%D0%B8%D0%BD%D0%B0&ludocid=1228788417052372849#lrd=0x47a84e025f326e25:0x110d888e0e856f71,1", 
      "reviews_id": "1228788417052372849", 
      "photo": "https://lh5.googleusercontent.com/p/AF1QipMXMPz-uBiB5FUMNfZzNpCRgP2k-rGhtxwtX2ot", 
      "working_hours": "\u0441\u0443\u0431\u043e\u0442\u0430: 12:00\u201316:00 | \u043d\u0435\u0434\u0456\u043b\u044f: \u0417\u0430\u0447\u0438\u043d\u0435\u043d\u043e | \u043f\u043e\u043d\u0435\u0434\u0456\u043b\u043e\u043a: 09:00\u201317:00 | \u0432\u0456\u0432\u0442\u043e\u0440\u043e\u043a: 09:00\u201317:00 | \u0441\u0435\u0440\u0435\u0434\u0430: 09:00\u201317:00 | \u0447\u0435\u0442\u0432\u0435\u0440: 09:00\u201317:00 | \u043f\u02bc\u044f\u0442\u043d\u0438\u0446\u044f: 09:00\u201317:00", 
      "reviews_per_score": "1: 4, 2: 0, 3: 1, 4: 1, 5: 36", 
      "verified": true, 
      "reserving_table_link": null, 
      "booking_appointment_link": null, 
      "owner_id": "103015253234697768004", 
      "owner_link": "https://www.google.com/maps/contrib/103015253234697768004", 
      "reviews_data": [
        {
          "google_id": "0x47a84e025f326e25:0x110d888e0e856f71", 
          "autor_link": "https://www.google.com/maps/contrib/115522604021340623220?hl=en-US", 
          "autor_name": "Omar Agha", 
          "autor_id": "115522604021340623220", 
          "review_text": "I would highly recommend Next Estate for their service and quick processes. The buy went very smooth and quick solutions were always brought to the table at any moment.\n\nWe are very happy and satisfied to have dealt with such a professional agency as Next Estate! Thanks to Zsanett and her team for the continuous effort to make our move as easy as possible.", 
          "review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s115522604021340623220!2s0x0:0x110d888e0e856f71?hl=en-US", 
          "review_rating": 5, 
          "review_timestamp": 1571046139, 
          "review_datetime_utc": "10/14/2019 09:42:19", 
          "review_likes": 2
        },
        ...
        {
          "google_id": "0x47a84e025f326e25:0x110d888e0e856f71", 
          "autor_link": "https://www.google.com/maps/contrib/115810197621281536714?hl=en-US", 
          "autor_name": "Erik Sundermann", 
          "autor_id": "115810197621281536714", 
          "review_text": "Jannik S\u00fchrig from Next Estate team was great to work with. He is highly professional, super responsive and proactively solving any issue on the horizon.", 
          "review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s115810197621281536714!2s0x0:0x110d888e0e856f71?hl=en-US", 
          "review_rating": 5, 
          "review_timestamp": 1556271619, 
          "review_datetime_utc": "04/26/2019 09:40:19", 
          "review_likes": null
        }
      ]
    },
    ...
  ]
}