Google Maps Contributor Reviews API Documentation

GET   /api/v1/search?engine=google_maps_contributor_reviews

The Google Maps Contributor Reviews API returns a Google Maps contributor's public profile and their newest reviews: the contributor's name, picture, Local Guide level, points and contribution counts, and up to 200 reviews, newest first, each with the place it reviews. Pass a contributor_id from the reviews of a Google Maps Reviews API response to see everything else that reviewer has written.

API Parameters

Search Query

  • Name
    contributor_id
    Required
    Required
    Description

    The ID of a Google Maps contributor. Get it from the reviews[].user.contributor_id field of the Google Maps Reviews API, or take the digits from a profile link such as https://www.google.com/maps/contrib/114339123323154895565/reviews. For example, a contributor_id looks like 114339123323154895565.

Localization

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the language of dates, place categories and aspect ratings. Reviews written in another language come with a translated_text in this language. Check the full list of supported Google hl languages.

  • Name
    gl
    Required
    Optional
    Description

    The default parameter us defines the country of the search. Check the full list of supported Google gl countries.

Pagination

  • Name
    num
    Required
    Optional
    Description

    Parameter defines how many of the contributor's newest entries to return, from 1 to 200. The list holds star-only ratings as well as written reviews. Google Maps shows at most a contributor's newest 200, so there are no further pages: search_information.total_reviews plus total_ratings tells how many the profile lists in total.

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_contributor_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

Full Response

Full Response

The contributor object is the profile: name, thumbnail, their Local Guide local_guide_level and points, the contributions counts as the profile shows them, and, when available, the description the contributor wrote and the points_to_next_level (below level 10). search_information has the review and rating totals the profile lists. reviews holds written reviews and star-only ratings, each with its rating, dates, likes, link and the reviewed place, whose data_id and place_id work with the Google Maps Place API. When available, a review also has its text and the language it was written in, rating_details, images (with a playable video file for a video) and the owner's response, and the place its city and price range.

GET
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_contributor_reviews",
  "contributor_id": "114339123323154895565"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_IS80kFYkHrGI22udQdQ8Guub",
    "status": "Success",
    "created_at": "2026-11-13T09:49:51Z",
    "request_time_taken": 0.78,
    "parsing_time_taken": 0.0,
    "total_time_taken": 0.78,
    "request_url": "https://www.google.com/maps/contrib/114339123323154895565/reviews?hl=en",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_GojFfqFUuLCVDyNLAjd3y48U.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_MXzZnVXbeK5BzNsIV6D9Uajd"
  },
  "search_parameters": {
    "engine": "google_maps_contributor_reviews",
    "contributor_id": "114339123323154895565",
    "hl": "en",
    "gl": "us",
    "num": 10
  },
  "contributor": {
    "contributor_id": "114339123323154895565",
    "name": "Elvis Jimenez",
    "link": "https://www.google.com/maps/contrib/114339123323154895565/reviews",
    "thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjXXUHVH0Gu7RtCxeSBqmhgIMnvjtv6TrWRCaxd8w45az-UtE78oFA=s120...",
    "description": "I live in Williamsburg Brooklyn NYC",
    "is_local_guide": true,
    "local_guide_level": 10,
    "points": 175155,
    "contributions": {
      "reviews": 1518,
      "ratings": 139,
      "photos": 23741,
      "videos": 1435,
      "captions": 39,
      "tips": 0,
      "answers": 24253,
      "edits": 9,
      "reported_incorrect": 1,
      "places_added": 39,
      "roads_added": 0,
      "q_and_a": 54,
      "trip_feedback": 1,
      "incident_reports": 1
    }
  },
  "search_information": {
    "total_reviews": 1201,
    "total_ratings": 102
  },
  "reviews": [
    {
      "position": 1,
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w0WWxscFgyWmZXVWMxZUdaSVVYYxAB",
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w...",
      "source": "Google",
      "text": "Nothing beats grabbing a fresh loaf of Italian bread here, sliced thick and toasted to perfection with a generous smear of butter, paired with a hot coffee. It’s the ultimate old-school breakfast ritual that keeps this neighborhood staple feeling like home. Simple, nostalgic, and absolutely unbeatable.",
      "rating": 5,
      "rating_details": {
        "food": 5,
        "service": 5,
        "atmosphere": 5
      },
      "date": "5 days ago",
      "iso_date": "2026-11-08T00:07:29Z",
      "language": "en",
      "likes": 0,
      "place": {
        "title": "Princesa Bakery",
        "address": "94 Graham Ave, Brooklyn, NY 11206",
        "city": "Brooklyn",
        "data_id": "0x89c25bfbfa4d6127:0xb71641bfd1f73f85",
        "place_id": "ChIJJ2FN-vtbwokRhT_30b9BFrc",
        "kgmid": "/g/1w3w3yyq",
        "type": "Bakery",
        "price": "$1 to $30",
        "rating": 4.2,
        "reviews": 1044,
        "gps_coordinates": {
          "latitude": 40.704415399999995,
          "longitude": -73.9425547
        },
        "thumbnail": "https://lh3.googleusercontent.com/grass-cs/AABkmLekw5ueQCoYpSW37lizoaVKUBFK3F9hnnxzF71Dpriii1jvN-ZtT..."
      }
    },
    "..."
  ]
}

Translated Reviews

Translated Reviews

hl sets the language of dates, place categories and aspect ratings. A review written in another language keeps its original text and adds a translated_text in the hl language.

GET
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews&gl=es&hl=es
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_contributor_reviews",
  "contributor_id": "114339123323154895565",
  "hl": "es",
  "gl": "es"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_cL4Lxn8JFHSbEFgEUVhKzMOW",
    "status": "Success",
    "created_at": "2026-11-13T09:49:52Z",
    "request_time_taken": 1.43,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.43,
    "request_url": "https://www.google.com/maps/contrib/114339123323154895565/reviews?hl=es",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_c1qHKeALNQjrS8wklOHPh9Nb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_3uzsCJH9XCAUwdCTA8bOmYIC"
  },
  "search_parameters": {
    "engine": "google_maps_contributor_reviews",
    "contributor_id": "114339123323154895565",
    "hl": "es",
    "gl": "es",
    "num": 10
  },
  "search_information": {
    "total_reviews": 1201,
    "total_ratings": 102
  },
  "reviews": [
    {
      "position": 1,
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w0WWxscFgyWmZXVWMxZUdaSVVYYxAB",
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w...",
      "source": "Google",
      "text": "Nothing beats grabbing a fresh loaf of Italian bread here, sliced thick and toasted to perfection with a generous smear of butter, paired with a hot coffee. It’s the ultimate old-school breakfast ritual that keeps this neighborhood staple feeling like home. Simple, nostalgic, and absolutely unbeatable.",
      "translated_text": "Nada supera disfrutar de una hogaza de pan italiano recién horneado, rebanado grueso y tostado a la perfección con una generosa capa de mantequilla, acompañado de un café caliente. Es el ritual de desayuno tradicional por excelencia que hace que este lugar emblemático del barrio se sienta como en casa. Sencillo, nostálgico e insuperable.",
      "rating": 5,
      "rating_details": {
        "comida": 5,
        "servicio": 5,
        "ambiente": 5
      },
      "date": "hace 5 días",
      "iso_date": "2026-11-08T00:07:29Z",
      "language": "en",
      "likes": 0,
      "place": {
        "title": "Princesa Bakery",
        "address": "94 Graham Ave, Brooklyn, NY 11206, Estados Unidos",
        "city": "Brooklyn",
        "data_id": "0x89c25bfbfa4d6127:0xb71641bfd1f73f85",
        "place_id": "ChIJJ2FN-vtbwokRhT_30b9BFrc",
        "kgmid": "/g/1w3w3yyq",
        "type": "Panadería",
        "price": "De 1 $ a 30 $",
        "rating": 4.2,
        "reviews": 1044,
        "gps_coordinates": {
          "latitude": 40.704415399999995,
          "longitude": -73.9425547
        },
        "thumbnail": "https://lh3.googleusercontent.com/grass-cs/AABkmLekw5ueQCoYpSW37lizoaVKUBFK3F9hnnxzF71Dpriii1jvN-ZtT..."
      }
    },
    "..."
  ]
}

Newest 200 Reviews

Newest 200 Reviews

num returns up to the contributor's newest 200 reviews and star-only ratings, the most Google Maps shows for one contributor. A profile can list more: compare search_information.total_reviews plus total_ratings with the number of entries returned. A contributor who keeps their review list private comes back with contributor and search_information and no reviews.

GET
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews&num=200
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_maps_contributor_reviews",
  "contributor_id": "114339123323154895565",
  "num": 200
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_WD4lFRgMhmdZyzeRUXDYKxDQ",
    "status": "Success",
    "created_at": "2026-11-13T09:50:09Z",
    "request_time_taken": 2.2,
    "parsing_time_taken": 0.01,
    "total_time_taken": 2.21,
    "request_url": "https://www.google.com/maps/contrib/114339123323154895565/reviews?hl=en",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_t0sGLSRhJbG3gkrMzcemj9y8.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_G6pWo81MCOwbzKsPZEPso9CF"
  },
  "search_parameters": {
    "engine": "google_maps_contributor_reviews",
    "contributor_id": "114339123323154895565",
    "hl": "en",
    "gl": "us",
    "num": 200
  },
  "search_information": {
    "total_reviews": 1201,
    "total_ratings": 102
  },
  "reviews": [
    {
      "position": 1,
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w0WWxscFgyWmZXVWMxZUdaSVVYYxAB",
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2poTk5IbDZTa2w...",
      "source": "Google",
      "text": "Nothing beats grabbing a fresh loaf of Italian bread here, sliced thick and toasted to perfection with a generous smear of butter, paired with a hot coffee. It’s the ultimate old-school breakfast ritual that keeps this neighborhood staple feeling like home. Simple, nostalgic, and absolutely unbeatable.",
      "rating": 5,
      "rating_details": {
        "food": 5,
        "service": 5,
        "atmosphere": 5
      },
      "date": "5 days ago",
      "iso_date": "2026-11-08T00:07:29Z",
      "language": "en",
      "likes": 0,
      "place": {
        "title": "Princesa Bakery",
        "address": "94 Graham Ave, Brooklyn, NY 11206",
        "city": "Brooklyn",
        "data_id": "0x89c25bfbfa4d6127:0xb71641bfd1f73f85",
        "place_id": "ChIJJ2FN-vtbwokRhT_30b9BFrc",
        "kgmid": "/g/1w3w3yyq",
        "type": "Bakery",
        "price": "$1 to $30",
        "rating": 4.2,
        "reviews": 1044,
        "gps_coordinates": {
          "latitude": 40.704415399999995,
          "longitude": -73.9425547
        },
        "thumbnail": "https://lh3.googleusercontent.com/grass-cs/AABkmLekw5ueQCoYpSW37lizoaVKUBFK3F9hnnxzF71Dpriii1jvN-ZtT..."
      }
    },
    "..."
  ]
}