Logo SearchApi

Google Maps Reviews API Documentation

GET   /api/v1/search?engine=google_maps_reviews
OpenAPI Initiative Download OpenAPI Spec
Breaking Changes
  • The search_query parameter has been deprecated and removed.
  • The topic_id parameter no longer accepts the previous numeric topic IDs. Use an id from the topics block, or a KGMID value such as /m/06mbny for "Hospitality".

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 reviews by topic. Topic ids are returned in the JSON response under the topics key, for example EFmBwTPtiaA for "kiosk ordering". KGMID values such as /m/06mbny for "Hospitality" are also accepted.

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.

  • Name
    gl
    Required
    Optional
    Description

    Parameter defines the country of the search. Check the full list of supported Google gl countries.

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.

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).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Reviews by data_id

Reviews by data_id

Returns user reviews for the specified place, along with a place_result summary (place ids, name, address, rating, and total review count) and the topics reviewers mention most. Each topic carries an id that can be passed back as topic_id to filter the reviews. When using pagination with next_page_token, only the reviews and pagination keys 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": {
    "ludocid": "3737724789719234788",
    "place_id": "ChIJhRwB-yFawokR5Phil-QQ3zM",
    "data_id": "0x89c25a21fb011c85:0x33df10e49762f8e4",
    "title": "Madison Square Garden",
    "address": "New York, NY 10001, United States",
    "rating": 4.7,
    "reviews": 34567
  },
  "topics": [
    {
      "id": "QxjcYUEveUc",
      "keyword": "knicks",
      "reviews": 746
    },
    ...
  ],
  "reviews": [
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xsaU1ITmlaRWhhYUZsNlZsOTRVMjlVZGpWaWFsRRAB",
      "user": {
        "name": "W Quinn",
        "link": "https://www.google.com/maps/contrib/107912972364967933380/reviews?hl=en-US",
        "contributor_id": "107912972364967933380",
        "is_local_guide": true,
        "reviews": 247,
        "photos": 1017,
        "thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjXVMEQ__hnZv_jUWBZO_Sm7n022dKUB0xG-ezSpF2LtktqrRqLf=s64-c-rp-mo-ba12-br100"
      },
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xsaU1ITmlaRWhhYUZsNlZsOTRVMjlVZGpWaWFsRRAB!2m1!1s0x0:0x33df10e49762f8e4!3m1!1s2@1:CAIQACodChtycF9oOlliMHNiZEhaaFl6Vl94U29UdjVialE%7C%7C?hl=en-US",
      "source": "Google",
      "text": "The Madison Square Garden Tour completely exceeded my expectations. Even if you’re not a huge sports fan, the history, energy, and behind-the-scenes access make this experience unforgettable. Walking through the arena and hearing stories about legendary concerts, iconic boxing matches, and unforgettable Knicks and Rangers moments.\n\nThe guide was knowledgeable, entertaining, and kept the tour engaging the entire time. My favorite part was seeing areas you normally never get access to and standing inside such a legendary venue that’s hosted so many historic events and performers.\n\nThe tour was well organized, easy to follow, and packed with interesting facts without ever feeling rushed. Whether you love music, sports, or New York history, this is absolutely worth doing. I’d recommend it to anyone visiting NYC — definitely one of the highlights of my trip!",
      "rating": 5,
      "date": "2 months ago",
      "iso_date": "2026-05-26T18:39:47Z",
      "likes": 0,
      "images": [
        {
          "id": "CIABIhBliRSuevKEeb8CYf3c-3Vd",
          "image": "https://lh3.googleusercontent.com/grass-cs/ACvplmNg-Uo6J5Wofq-FwlY6bwbfZz0YtZVXYwiNFnjZinNP50A0cnr5GTbx7lFa3STuY-wlBFkIIshQ3hEJILMsOjPUscz7djJ0Ob_IUDR0PeffElGqGuqqYyIYvkr3NsgZNABvHelp0MK_0WXQ=k-no"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "next_page_token": "OkRDakVJQVJJcENnb0FQN19MQUJ3R19fX19FaERNM0FBSnV6OFh5dlYxMjlFQUFBQUFHZ245MlBNQ1lhTDJnNkVZQUNJQUoA"
  }
}

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": {
    "ludocid": "3737724789719234788",
    "place_id": "ChIJhRwB-yFawokR5Phil-QQ3zM",
    "data_id": "0x89c25a21fb011c85:0x33df10e49762f8e4",
    "title": "Madison Square Garden",
    "address": "New York, NY 10001, United States",
    "rating": 4.7,
    "reviews": 34567
  },
  "topics": [
    {
      "id": "QxjcYUEveUc",
      "keyword": "knicks",
      "reviews": 746
    },
    ...
  ],
  "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"
        },
        ...
      ]
    },
    ...
  ],
  "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
{
  "search_metadata": {
    "id": "search_OxE2l6wMgOJVSOwKp9PbYq4K",
    "status": "Success",
    "created_at": "2026-08-05T20:39:17Z",
    "request_time_taken": 1.08,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.09,
    "request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x80dcef251a4f2045:0xd38910d460cb7a95!8m2!3d0!4d0",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVSOwKp9PbYq4K.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVSOwKp9PbYq4K"
  },
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x80dcef251a4f2045:0xd38910d460cb7a95",
    "topic_id": "/m/016bn0",
    "hl": "en",
    "num": 10
  },
  "place_result": {
    "ludocid": "15242732918155213461",
    "place_id": "ChIJRSBPGiXv3IARlXrLYNQQidM",
    "data_id": "0x80dcef251a4f2045:0xd38910d460cb7a95",
    "title": "The Original Pancake House",
    "address": "26951 Moulton Pkwy, Aliso Viejo, CA 92656, United States",
    "rating": 4.5,
    "reviews": 1126
  },
  "topics": [
    {
      "id": "AQhRkejtfBA",
      "keyword": "veggie omelette",
      "reviews": 10
    },
    ...
  ],
  "reviews": [
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xScE5HdFhNMjF6VFhveWNWQTNVakZ5VGtJdExWRRAB",
      "user": {
        "name": "Anthony B",
        "link": "https://www.google.com/maps/contrib/107948785454078719388/reviews?hl=en-US",
        "contributor_id": "107948785454078719388",
        "is_local_guide": true,
        "reviews": 153,
        "photos": 633,
        "thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjWr4sWsytc0nsVHSLTFZV51Jfy63m7K8o3La548irMKokng7o8-=s64-c-rp-mo-ba12-br100"
      },
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xScE5HdFhNMjF6VFhveWNWQTNVakZ5VGtJdExWRRAB!2m1!1s0x0:0xd38910d460cb7a95!3m1!1s2@1:CAIQACodChtycF9oOlRpNGtXM21zTXoycVA3UjFyTkItLVE%7C%7C?hl=en-US",
      "source": "Google",
      "text": "OMG the omelets are huge and amazing, they are seasoned thru out and you can taste all the ingredients, This is the western omelette(I absolutely promise that this is a top-tier 100 A+ + omelette) with three cheeses.\nThe pancakes were really good buttermilk pancakes the syrup was served warm.\nVery very very good",
      "rating": 5,
      "rating_details": {
        "food": 5,
        "service": 5,
        "atmosphere": 5
      },
      "date": "10 months ago",
      "iso_date": "2025-09-30T20:12:55Z",
      "likes": 1,
      "images": [
        {
          "id": "CIABIhBmYYcAVlzi6gISyPY3Fo_T",
          "image": "https://lh3.googleusercontent.com/grass-cs/ACvplmOo7dif2gWYfJvPyce5VWHpOJNK9JqqeiivLIl0ny6ZSN5KupZ1NikQUuMP0YWUppmQnYX1-u_r-PE9GA3RmxrYF4MFCIKI05MBqFZ3dJf6rZdSoDvTSyOPsJZ5OrK88S4N7zHru7EGs1I=k-no"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "next_page_token": "OkRDakVJQVJJcENnb0FQN19MQldtMV9fX19FaEFTVTh2QndPYUdPYm81ZUlvQUFBQUFHZ245MmNJQ2M2LVprY1lZQUNJQUoA"
  }
}