Google Maps Contributor Reviews API Documentation
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_idfield of the Google Maps Reviews API, or take the digits from a profile link such ashttps://www.google.com/maps/contrib/114339123323154895565/reviews. For example, acontributor_idlooks like114339123323154895565.
Localization
-
- Name
-
hl - Required
- Optional
- Description
-
The default parameter
endefines the language of dates, place categories and aspect ratings. Reviews written in another language come with atranslated_textin this language. Check the full list of supported Googlehllanguages.
-
- Name
-
gl - Required
- Optional
- Description
-
The default parameter
usdefines the country of the search. Check the full list of supported Googleglcountries.
Pagination
-
- Name
-
num - Required
- Optional
- Description
-
Parameter defines how many of the contributor's newest entries to return, from
1to200. 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_reviewsplustotal_ratingstells 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_keyauthenticates 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
trueto 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
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.
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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.
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews&gl=es&hl=es
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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.
https://www.searchapi.io/api/v1/search?contributor_id=114339123323154895565&engine=google_maps_contributor_reviews&num=200
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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..."
}
},
"..."
]
}