Google Maps Reviews API

The Google Maps Reviews API retrieves customer reviews from any Google Maps listing. Sort by quality, newest, or rating. Filter by topic. Returns reviewer details, ratings, review text, images, and response metadata.

Endpoint: https://api.scrapingdog.com/google_maps/reviews

API Parameters

🔑

Authentication

api_key Required
Your personal API key. Available on your dashboard.

Type: String

📍

Location

data_id Required
The Google Maps data ID. You can get this by entering the location name as the query in our Google Maps API.

Type: String

🌍

Localization

language Optional
Language of the results. Possible Values: en, es, fr, de, etc. Default: en. For a full list, see the Google Language Page.

Type: String

⚙

️ Advanced Parameters

sort_by Optional
Sort order for reviews. Options: qualityScore (most relevant, default), newestFirst (most recent), ratingHigh (highest rated), ratingLow (lowest rated).

Type: String
topic_id Optional
The ID of the topic to filter the reviews. You can find these IDs in our JSON response.

Type: String
results Optional
Maximum number of results to return. Valid range: 1 to 20. Default: 10. Note: Cannot be used on the first page without next_page_token or topic_id — response will contain 8 results in that case.

Type: Numeric

📄

Pagination

next_page_token Optional
The next_page_token is used to get the next page results.

Type: String

API Examples

Code to Integrate

curl "https://api.scrapingdog.com/google_maps/reviews?api_key=APIKEY&data_id=0x89c25090129c363d:0x40c6a5770d25022b"

import requests

params = {
    "api_key": "APIKEY",
    "data_id": "0x89c25090129c363d:0x40c6a5770d25022b",
}

response = requests.get("https://api.scrapingdog.com/google_maps/reviews", params=params)
print(response.json())

const axios = require("axios");

axios.get("https://api.scrapingdog.com/google_maps/reviews", {
  params: { api_key: "APIKEY", data_id: "0x89c25090129c363d:0x40c6a5770d25022b" }
}).then(res => console.log(res.data));

<?php
$params = http_build_query(["api_key" => "APIKEY", "data_id" => "0x89c25090129c363d:0x40c6a5770d25022b"]);
$response = file_get_contents("https://api.scrapingdog.com/google_maps/reviews?" . $params);
print_r(json_decode($response, true));

require "net/http"
require "json"

uri = URI("https://api.scrapingdog.com/google_maps/reviews")
uri.query = URI.encode_www_form(api_key: "APIKEY", data_id: "0x89c25090129c363d:0x40c6a5770d25022b")
puts JSON.parse(Net::HTTP.get_response(uri).body)

HttpURLConnection con = (HttpURLConnection) new URL("https://api.scrapingdog.com/google_maps/reviews?api_key=APIKEY&data_id=0x89c25090129c363d:0x40c6a5770d25022b").openConnection();
con.setRequestMethod("GET");

API Response

{
  "locationDetails": {
    "title": "Blue Bottle Coffee",
    "address": "450 W 15th St, New York, NY 10011",
    "rating": 4.6,
    "total_reviews": 531
  },
  "topics": [
    { "keyword": "cold brew", "mentions": 48, "id": "/m/06b_j" },
    { "keyword": "pour over", "mentions": 35, "id": "/m/04hl_n" },
    { "keyword": "espresso", "mentions": 29, "id": "/m/02vqfh" }
  ],
  "reviews_results": [
    {
      "rating": 5,
      "date": "2 weeks ago",
      "snippet": "Absolutely the best coffee in the city. The single-origin pour over is exceptional and the staff really knows their stuff.",
      "user": { "name": "Sarah M.", "reviews": 42, "thumbnail": "https://lh3.googleusercontent.com/..." },
      "images": ["https://lh3.googleusercontent.com/review-img..."]
    },
    {
      "rating": 4,
      "date": "1 month ago",
      "snippet": "Great atmosphere, solid espresso drinks. Can get crowded on weekends but worth it.",
      "user": { "name": "James T.", "reviews": 18, "thumbnail": "https://lh3.googleusercontent.com/..." }
    }
  ],
  "pagination": {
    "next_page_token": "CAESBkVnSUlDQQ==",
    "next": "https://api.scrapingdog.com/google_maps/reviews?api_key=APIKEY&data_id=0x89c25090129c363d:0x40c6a5770d25022b&next_page_token=CAESBkVnSUlDQQ=="
  }
}