# Google Maps Reviews API

{% hint style="success" %}
To enable this engine, set the **`engine=google_maps_reviews`** parameter.
{% endhint %}

If you only want to scrape the Google Maps Reviews, you can do so by simply interacting with the Google Maps Reviews API. This engine will return a JSON object of all the reviews available, based on your query.

<figure><img src="https://1192456954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9wbsYOleiAqS785aMtPp%2Fuploads%2FB5aZMNGBlRWIcLs6nFdd%2Fgoogle-maps-reviews-api.png?alt=media&#x26;token=5aa054cb-0402-498e-9bc2-a956f5211b68" alt=""><figcaption><p>Scrape Google Maps Reviews</p></figcaption></figure>

### Google Maps Reviews API Integration Examples

We will use following URL as an example for this request:

{% code overflow="wrap" %}

```
https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=<YOUR_API_KEY>&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5
```

{% endcode %}

### Ready to Use Google Maps Reviews Scraping Scripts:

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```bash
curl --request GET --url "https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5"
```

{% endcode %}
{% endtab %}

{% tab title="NodeJS" %}
{% code overflow="wrap" %}

```javascript
const http = require("https");

const options = {
  "method": "GET",
  "hostname": "serpapi.webscrapingapi.com",
  "port": null,
  "path": "/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5",
  "headers": {}
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import http.client

conn = http.client.HTTPSConnection("serpapi.webscrapingapi.com")

conn.request("GET", "/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&ffid=0x4786c6ace45fe3bd:0x126d84580eedebe5")

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code overflow="wrap" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

{% endcode %}
{% endtab %}

{% tab title="Go" %}
{% code overflow="wrap" %}

```go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}
{% code overflow="wrap" %}

```java
HttpResponse<String> response = Unirest.get("https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5")
  .asString();
```

{% endcode %}
{% endtab %}

{% tab title=".NET" %}
{% code overflow="wrap" %}

```csharp
var client = new RestClient("https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

{% endcode %}
{% endtab %}

{% tab title="Ruby" %}
{% code overflow="wrap" %}

```ruby
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://serpapi.webscrapingapi.com/v2?engine=google_maps_reviews&api_key=YOUR_API_KEY&fid=0x4786c6ace45fe3bd:0x126d84580eedebe5")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Google Maps Reviews Parameters

#### #1: Query Parameter

<table><thead><tr><th width="187">Parameter</th><th width="107" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>fid</code><br><mark style="color:red;background-color:red;">Required</mark></td><td align="center"><code>string</code></td><td>Feature id what you want to fetch reviews to. <code>fid</code> parameter can be found in <code>knowledge.fid</code> field of google search response.</td></tr></tbody></table>

#### #2: Request Customisation Parameters

<table><thead><tr><th width="184">Parameter</th><th width="106" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>sort</code></td><td align="center"><code>string</code></td><td>The way reviews are sorted. <br>Possible values are:<br><code>sort=qualityScore</code> (default) - most relevant first<br><code>sort=newestFirst</code> - newest first<br><code>sort=ratingHigh</code> - highest rating first<br><code>sort=ratingLow</code> - lowest rating first</td></tr><tr><td><code>filter</code></td><td align="center"><code>string</code></td><td>Filter keyword. Will respond with reviews that contain specified keyword only.</td></tr></tbody></table>

#### #3: Geolocation Parameters

<table><thead><tr><th width="184">Parameter</th><th width="106" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>hl</code></td><td align="center"><code>string</code></td><td>The language you want to use for your Google search. <a href="https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages">List of supported languages</a></td></tr></tbody></table>

#### #4: Pagination Parameters

<table><thead><tr><th width="185">Parameter</th><th width="106" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>start</code></td><td align="center"><code>int</code></td><td>The offset of the Google Maps results. Represents the number of results that you want to skip.</td></tr><tr><td><code>num</code></td><td align="center"><code>int</code></td><td>The number of results returned on each page.</td></tr></tbody></table>

<details>

<summary>Response Example</summary>

```javascript
{
    "0": null,
    "1": "CAESY0NBRVFDaHBFUTJwRlNVRlNTWEJEWjI5QlVEZGZURUZEVG0xZlgxOWZSV2hDZDFOcVJETlhkR3hTYXpGV1pIQktaMEZCUVVGQlIyZHVPVEpRVVVOaVpGWjZTVmMwV1VGRFNVRQ==",
    "2": [
        [
            [
                "ChdDSUhNMG9nS0VJQ0FnSURuX0pHSG53RRAB",
                [
                    "0x0:0x126d84580eedebe5",
                    null,
                    1728031749372842,
                    1728031749372842,
                    [
                        null,
                        null,
                        [
                            "https://www.google.com/maps/contrib/116151149913474239827/reviews?hl=en"
                        ],
                        null,
                        null,
                        [
                            "Amir Mehrpanah",
                            "https://lh3.googleusercontent.com/a-/ALV-UjVfFADSZckquBwjYnxz-vx23UPZfuLe_3Nl4RSrGKoENU9GBNuF=s120-c-rp-mo-ba5-br100",
                            [
                                "https://www.google.com/maps/contrib/116151149913474239827?hl=en"
                            ],
                            "116151149913474239827",
                            null,
                            170,
                            740,
                            null,
                            [
                                1,
                                7,
                                1
                            ],
                            17,
                            [
                                "Local Guide · 170 reviews",
                                null,
                                null,
                                null,
                                null,
                                [
                                    null,
                                    "0ahUKEwiF9MjqvY2JAxV55QIHHUi1ILUQ7LoGCAMoAA"
                                ]
                            ]
                        ]
                    ],
                    null,
                    "a week ago",
                    null,
                    null,
                    null,
                    null,
                    null,
                    null,
                    [
                        "Google",
                        "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
                        null,
                        "google",
                        5
                    ],
                    null,
                    1
                ],
                [
                    [
                        5
                    ],
                    null,
                    [
                        [
                            "AF1QipP9_RggXY6Q9qkiSGtgxS6yFkodtVozUINGAkEn",
                            [
                                "AF1QipP9_RggXY6Q9qkiSGtgxS6yFkodtVozUINGAkEn",
                                10,
                                12,
                                null,
                                null,
                                null,
                                [
                                    "https://lh5.googleusercontent.com/p/AF1QipP9_RggXY6Q9qkiSGtgxS6yFkodtVozUINGAkEn=w150-h150-k-no-p",
                                    null,
                                    [
                                        3472,
                                        4624
                                    ]
                                ],
                                null,
                                [
                                    [
                                        3,
                                        9.18618630886349,
                                        45.464945927108126
                                    ],
                                    [
                                        0,
                                        90
                                    ],
                                    [
                                        3472,
                                        4624
                                    ],
                                    75
                                ],
                                "QdoMZ8XPH_nKi-gPyOqCqQs",
                                "0ahUKEwiF9MjqvY2JAxV55QIHHUi1ILUQzCcIBCgB",
                                [
                                    "//www.google.com/local/imagery/report/?cb_client=maps_sv.tactile&image_key=!1e10!2sAF1QipP9_RggXY6Q9qkiSGtgxS6yFkodtVozUINGAkEn",
                                    null,
                                    null,
                                    "0ahUKEwiF9MjqvY2JAxV55QIHHUi1ILUQ-y4IBSgA"
                                ],
                                null,
                                null,
                                null,
                                null,
                                null,
                                null,
                                null,
                                null,
                                null,
                                [
                                    null,
                                    [
                                        10,
                                        "AF1QipP9_RggXY6Q9qkiSGtgxS6yFkodtVozUINGAkEn"
                                    ],
                                    [
                                        10,
                                        3,
                                        [
                                            4624,
                                            3472
                                        ]
                                    ],
                                    [
                                        null,
                                        null,
                                        null,
                                        null,
                                        null,
                                        null,
                                        null,
                                        [
                                            "Starbucks Reserve Roastery"
                                        ]
                                    ],
                                    [
                                        null,
                                        [
                                            [
                                                [
                                                    "Amir Mehrpanah"
                                                ],
                                                "https://www.google.com/maps/contrib/116151149913474239827?hl=en",
                                                "https://lh3.googleusercontent.com/a-/ALV-UjVfFADSZckquBwjYnxz-vx23UPZfuLe_3Nl4RSrGKoENU9GBNuF=s120-c-rp-mo-ba5-br100"
                                            ]
                                        ]
                                    ],
                                    [
                                        [
                                            [
                                                2
                                            ],
                                            [
                                                [
                                                    null,
                                                    null,
                                                    null,
                                                    null,
                                                    1
                                                ]
                                            ]
                                        ]
                                    ],
...
```

</details>