Google Maps Reviews API Documentation

The Google Maps Reviews API allows access to user-generated reviews for businesses and points of interest. It provides details such as reviewer information, ratings, review text, images, and more. The API can be used to search for reviews of local businesses, tourist attractions, and other points of interest based on various topic_ids.

API Parameters

Search Query

  • Name
    place_id
    Required
    Required
    Description

    This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a place_id look like ChIJhRwB-yFawokR5Phil-QQ3zM. More details about place_id can be found in the Google Maps Place ID documentation.

    Note: The place_id parameter is not required if data_id parameter is being used.

  • Name
    data_id
    Required
    Required
    Description

    This parameter is a unique identifier for locations on Google Maps, including businesses, landmarks, and more. It can be obtained using the Google Maps API and is used to access detailed information about a place. For example, a data_id look like 0x89c25a21fb011c85:0x33df10e49762f8e4.

    Note: The data_id parameter is not required if place_id parameter is being used.

Filters

  • Name
    sort_by
    Required
    Optional
    Description

    This parameter sorts results based on the following values:

    • most_relevant - default sort order.
    • newest
    • highest_rating
    • lowest_rating

  • Name
    topic_id
    Required
    Optional
    Description

    Parameter filters results based on topic. Check the topics array in the JSON response to find these IDs.

  • Name
    search_query
    Required
    Optional
    Description

    Parameter filters results based on query. You can use it to search for specific keywords in reviews.

    Note: The search_query can't be used together with the topic_id parameter. If used, topic_id is prioritized and search_query is ignored.

Localization

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Parameter defines the next page token that is used to retrieve the next page of reviews. Next page token can be found in the JSON response under pagination key.

  • Name
    num
    Required
    Optional
    Description

    Parameter defines the number of reviews to return. The default value is 10 and the maximum value is 20. Parameter is supported only when using together with the next_page_token, search_query, or topic_id parameter.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_maps_reviews.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Reviews by data_id

Reviews by data_id

The first page of reviews returns the values for place_result and topics. When using pagination, only the reviews are returned.

GET
https://www.searchapi.io/api/v1/search?data_id=0x89c25a21fb011c85%3A0x33df10e49762f8e4&engine=google_maps_reviews
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_reviews",
  "data_id": "0x89c25a21fb011c85:0x33df10e49762f8e4"
}

response = requests.get(url, params = params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_mQdZY24X3k8NtLVlpyxG15W7",
    "status": "Success",
    "created_at": "2024-04-12T16:43:19Z",
    "request_time_taken": 1.41,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.42,
    "request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x89c25a21fb011c85:0x33df10e49762f8e4!8m2!3d21.1714392!4d-30.3258504?",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_mQdZY24X3k8NtLVlpyxG15W7.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_mQdZY24X3k8NtLVlpyxG15W7"
  },
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x89c25a21fb011c85:0x33df10e49762f8e4",
    "hl": "en"
  },
  "place_result": {
    "title": "Madison Square Garden",
    "address": "4 Pennsylvania Plaza, New York, NY 10001",
    "phone": "+1 212-465-6000",
    "rating": 4.7,
    "reviews": 30269,
    "reviews_histogram": {
      "1": 448,
      "2": 272,
      "3": 1052,
      "4": 5022,
      "5": 23475
    },
    "type": "Arena"
  },
  "topics": [
    {
      "id": "/m/0jm3v",
      "keyword": "knicks",
      "reviews": 913
    },
    ...
  ],
  "reviews": [
    {
      "review_id": "ChZDSUhNMG9nS0VJQ0FnSUREeW9LZkhREAE",
      "user": {
        "name": "JemD HOP",
        "link": "https://www.google.com/maps/contrib/101628556982777975710?hl=en-US",
        "contributor_id": "101628556982777975710",
        "is_local_guide": true,
        "reviews": 194,
        "photos": 202,
        "thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocLT2rZlGHTiy38fKZRIlSD8Ii-cF0a4_Xnhfd2M55iX9NbAHQ=s120-c-rp-mo-ba5-br100"
      },
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUREeW9LZkhREAE!2m1!1s0x0:0x33df10e49762f8e4!3m1!1s2@1:CIHM0ogKEICAgIDDyoKfHQ%7CCgsI_LjMsAYQkKqIKw%7C?hl=en-US",
      "source": "Google",
      "snippet": "Fantastic visit. We watched an ice hockey match. ๐Ÿ’  loved every second. The venue is clean tidy and well equipped. The bars had a great selection and it was easy to find our seats and to get in and out. Security was good and the staff were so friendly. Great first experience.",
      "rating": 5,
      "date": "4 days ago",
      "extracted_date": "2024-04-07 22:21:48 UTC",
      "likes": 0,
      "images": [
        {
          "id": "AF1QipMKBbj1HTBYtB8TCqRvLz2jtR75C8O5vCBX68LF",
          "image": "https://lh5.googleusercontent.com/p/AF1QipMKBbj1HTBYtB8TCqRvLz2jtR75C8O5vCBX68LF=w150-h150-k-no-p"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "next_page_token": "CAESBkVnSUlDQQ=="
  }
}

Reviews by place_id

Reviews by place_id
GET
https://www.searchapi.io/api/v1/search?engine=google_maps_reviews&place_id=ChIJhRwB-yFawokR5Phil-QQ3zM
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_reviews",
  "place_id": "ChIJhRwB-yFawokR5Phil-QQ3zM"
}

response = requests.get(url, params = params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_BxR6dazVoAVkFlqO3Ewvbj9G",
    "status": "Success",
    "created_at": "2024-07-15T13:14:08Z",
    "request_time_taken": 3.3,
    "parsing_time_taken": 0.01,
    "total_time_taken": 3.31,
    "request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x89c25a21fb011c85:0x33df10e49762f8e4!8m2!3d21.1714392!4d-30.3258504",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFlqO3Ewvbj9G.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFlqO3Ewvbj9G"
  },
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x89c25a21fb011c85:0x33df10e49762f8e4",
    "place_id": "ChIJhRwB-yFawokR5Phil-QQ3zM",
    "hl": "en",
    "num": 10
  },
  "place_result": {
    "title": "Madison Square Garden",
    "address": "New York, NY 10001",
    "phone": "+1 212-465-6000",
    "rating": 4.7,
    "reviews": 30469,
    "reviews_histogram": {
      "1": 459,
      "2": 273,
      "3": 1055,
      "4": 5041,
      "5": 23641
    },
    "type": "Arena"
  },
  "topics": [
    {
      "id": "/m/0jm3v",
      "keyword": "knicks",
      "reviews": 937
    },
    {
      "id": "/m/0b_j2",
      "keyword": "billy joel",
      "reviews": 357
    },
    ...
  ],
  "reviews": [
    {
      "review_id": "ChZDSUhNMG9nS0VJQ0FnSUNyaWRtTWFREAE",
      "user": {
        "name": "Elijah Orama",
        "link": "https://www.google.com/maps/contrib/100323088318742979214?hl=en-US",
        "contributor_id": "100323088318742979214",
        "is_local_guide": true,
        "reviews": 56,
        "photos": 582,
        "thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjUYGY5tw0qNkE15llQVIubMivxiRqIq9JfIWU5XTdN804bHji8S=s120-c-rp-mo-ba5-br100"
      },
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUNyaWRtTWFREAE!2m1!1s0x0:0x33df10e49762f8e4!3m1!1s2@1:CIHM0ogKEICAgICridmMaQ%7CCgwIzISwtAYQ4JL80wM%7C?hl=en-US",
      "source": "Google",
      "text": "We took a private tour of the worldโ€™s most famous venue, Madison Square Garden. I have personally never been to this arena but it was awesome. The amount of history that has gone through this building is crazy. Have to give it up to our tour guide who was very funny and friendly. Also, they were setting up for a Justin Timberlake concert! Great time.",
      "rating": 5,
      "rating_details": {
        "wait_time": "Up to 10 min",
        "reservation_recommended": "No"
      },
      "date": "6 days ago",
      "iso_date": "2024-07-08T15:14:20Z",
      "images": [
        {
          "id": "AF1QipNhUBWfIXBNDHTjgobKLBSiII_jGR8905LhJt7v",
          "image": "https://lh5.googleusercontent.com/p/AF1QipNhUBWfIXBNDHTjgobKLBSiII_jGR8905LhJt7v=w150-h150-k-no-p"
        },
        {
          "id": "AF1QipMBXvagtwaYe2UhcHEj73suFMwiyJxxAsp-B0tY",
          "image": "https://lh5.googleusercontent.com/p/AF1QipMBXvagtwaYe2UhcHEj73suFMwiyJxxAsp-B0tY=w150-h150-k-no-p"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "next_page_token": "CAESY0NBRVFDQnBFUTJwRlNVRlNTWEJEWjI5QlVEZGZURUZEU0hoZlgxOWZSV2hCU0dsVVdUbFFkbUZGTnpsMFFtVkJTVUZCUVVGQlIyZHVPVEpRVVVOaU5HRlROV3RCV1VGRFNVRQ=="
  }
}

Filter Reviews by Topic

Filter Reviews by Topic
GET
https://www.searchapi.io/api/v1/search?data_id=0x80dcef251a4f2045%3A0xd38910d460cb7a95&engine=google_maps_reviews&topic_id=%2Fm%2F016bn0
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_reviews",
  "data_id": "0x80dcef251a4f2045:0xd38910d460cb7a95",
  "topic_id": "/m/016bn0"
}

response = requests.get(url, params = params)
print(response.text)
Response
{
  "reviews": [
    {
      "review_id": "ChdDSUhNMG9nS0VJQ0FnSURWNTdmaHl3RRAB",
      "user": {
        "name": "a nashmi",
        "link": "https://www.google.com/maps/contrib/103302355653619994194?hl=en",
        "contributor_id": "103302355653619994194",
        "is_local_guide": true,
        "reviews": 155,
        "photos": 881,
        "thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocJHroTCJMrpRXHOg2-06vGqwkpwMo-0i4y0aZTEdANhoLgIqQ=s120-c-rp-mo-ba5-br100"
      },
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSURWNTdmaHl3RRAB!2m1!1s0x0:0xd38910d460cb7a95!3m1!1s2@1:CIHM0ogKEICAgIDV57fhywE%7CCgwI3NCCrAYQiJ3_sgI%7C?hl=en",
      "source": "Google",
      "text": "A wonderful restaurant that serves a variety of dishes from omelettes and delicious pancakes with types of jam and honey, with the possibility of adding Swiss cheese and cheddar cheese with a cup of hot American coffee. Suitable for all family members. I recommend visiting it to experience the unique taste and unique pleasure ๐Ÿ‘Œ๐Ÿป",
      "rating": 5,
      "date": "4 months ago",
      "iso_date": "2023-12-18T20:15:24Z",
      "likes": 0,
      "images": [
        {
          "id": "AF1QipO690sK88udJSW8uLZS7-Fr5pdetLUhqlgTpGeH",
          "image": "https://lh5.googleusercontent.com/p/AF1QipO690sK88udJSW8uLZS7-Fr5pdetLUhqlgTpGeH=w150-h150-k-no-p"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "next_page_token": "CAESdkNBRVFDaHBTUTJkblNVRm9TVUZIUVVWcFFVRnZlRU5CUlZOTFVXOUxRVVF0WDNsM01HaFdVRjlmWDNoSlVXSkRhRVZrWVRadGIxUnFaM1pETFhSQlFVRkJRVUp2U2w5a2NuZEJjVVJCVm5sdFdrZEJRV2xCUVE="
  }
}