Google Maps Reviews API

Find business locations, read customer reviews and check merchant responses using search queries or place URLs.

Use links that identify a specific place; preserve returned place identifiers when separating branches, reviews and merchant responses.

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each Google Maps Reviews action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health
SearchsearchFind places on Google Maps for a name or business type in keyword, with Google place ID, address, coordinates, phone, website, rating, review count and closure status.$1.39 per 1,000 requestsNormal
Place detailsprofileGet a Google Maps place from its full url with address, plus code, coordinates, phone, website, rating, review count, opening hours and temporary or permanent closure.$1.39 per 1,000 requestsNormal
ReviewsreviewsRead reviews of one Google Maps place, each with rating, reviewer name and review count, Local Guide badge, likes, photos, detailed ratings and any owner response.$1.39 per 1,000 requestsNormal

Open a capability for its parameters, response fields, code samples and trial.

What does each Google Maps Reviews action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
search

Search

Find places on Google Maps for a name or business type in keyword, with Google place ID, address, coordinates, phone, website, rating, review count and closure status. Page through with page_token, up to 120 rows in total; going past 60 rows requires async mode.

keywordcountry, language, location, page_tokenSync deliveryCatalog values: defaultLimit=15, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. For the next page, pass next_page_token back as page_token with the other parameters unchanged; each page is one call. Pages go up to 120 rows; beyond 60 rows, request the page with mode=async.$1.39 per 1,000 requestsplace_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform
profile

Place details

Get a Google Maps place from its full url with address, plus code, coordinates, phone, website, rating, review count, opening hours and temporary or permanent closure. Prefer the URL returned by search, since a bare name-and-coordinates link may not match the same business.

urlcity, language, since, sortSync delivery—$1.39 per 1,000 requestsplace_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform
reviews

Reviews

Read reviews of one Google Maps place, each with rating, reviewer name and review count, Local Guide badge, likes, photos, detailed ratings and any owner response. Pick the language with lang and page with page_token, up to 400 rows; going past 200 requires async mode.

urllang, language, page_token, since, sortSync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. For the next page, pass next_page_token back as page_token with the other parameters unchanged; each page is one call. Pages go up to 400 rows; beyond 200 rows, request the page with mode=async.$1.39 per 1,000 requestsid · text · rating · rating_scale · reviewer_name · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform

What do the Google Maps Reviews search parameters mean?

Find places on Google Maps for a name or business type in keyword, with Google place ID, address, coordinates, phone, website, rating, review count and closure status. Page through with page_token, up to 120 rows in total; going past 60 rows requires async mode.

Full API reference: parameters, code samples, response example and health →
keywordRequired
A Google Maps place name, business type, or place query, such as dentist or dentist in Chicago. search finds places; it does not search the text of reviews for an existing business.
countryOptional
The country or region code used to establish search context, such as us; the default is us. It is not a guarantee that every returned business is located in that country.
languageOptional
The language used for the query or page content; the default is en. For reviews, lang overrides this value when both are supplied. This setting does not guarantee that every review was written in that language.
locationOptional
The place text combined with keyword for search, such as Chicago. Avoid supplying a location that conflicts with a location already embedded in the keyword.
page_tokenOptional
Pagination token: pass back next_page_token from the previous response to get the next page; omit it for the first page. Keep every other parameter unchanged. Tokens last 24 hours and each page is one call.

What do the Google Maps Reviews profile parameters mean?

Get a Google Maps place from its full url with address, plus code, coordinates, phone, website, rating, review count, opening hours and temporary or permanent closure. Prefer the URL returned by search, since a bare name-and-coordinates link may not match the same business.

Full API reference: parameters, code samples, response example and health →
urlRequired
A full Google Maps place URL, preferably the URL returned by search with query_place_id preserved. A /place/ URL containing only a name and coordinates may not identify the same business reliably. Use profile for place details and reviews for that place's reviews.
Google Maps: Place Links and Place IDs — Google Maps links use `query_place_id` to identify a specific location directly rather than relying only on location names or coordinates. · Checked
cityOptional
A city constraint for place discovery. Although the profile action also exposes this parameter, it cannot move a known business to another city or reliably replace the place URL.
languageOptional
The language used for the query or page content; the default is en. For reviews, lang overrides this value when both are supplied. This setting does not guarantee that every review was written in that language.
sinceOptional
The lower publication-date boundary for reviews, preferably in YYYY-MM-DD format. It is not the business opening date. Its presence on the profile action does not mean place details are filtered by opening date.
sortOptional
The review order: newest for recent reviews or relevance for the platform's relevance order. Reviews default to newest. On profile, the same name can affect attached review data but does not sort the single place object.
Allowed values:newestrelevance

What do the Google Maps Reviews reviews parameters mean?

Read reviews of one Google Maps place, each with rating, reviewer name and review count, Local Guide badge, likes, photos, detailed ratings and any owner response. Pick the language with lang and page with page_token, up to 400 rows; going past 200 requires async mode.

Full API reference: parameters, code samples, response example and health →
urlRequired
A full Google Maps place URL, preferably the URL returned by search with query_place_id preserved. A /place/ URL containing only a name and coordinates may not identify the same business reliably. Use profile for place details and reviews for that place's reviews.
Google Maps: Place Links and Place IDs — Google Maps links use `query_place_id` to identify a specific location directly rather than relying only on location names or coordinates. · Checked
langOptional
The reviews language option, such as en, zhcn, or zhtw; use the action's complete allowed-value list. It takes precedence over language. It does not filter by a review author's nationality.
Allowed values:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu
languageOptional
The language used for the query or page content; the default is en. For reviews, lang overrides this value when both are supplied. This setting does not guarantee that every review was written in that language.
page_tokenOptional
Pagination token: pass back next_page_token from the previous response to get the next page; omit it for the first page. Keep every other parameter unchanged. Tokens last 24 hours and each page is one call.
sinceOptional
The lower publication-date boundary for reviews, preferably in YYYY-MM-DD format. It is not the business opening date. Its presence on the profile action does not mean place details are filtered by opening date.
sortOptional
The review order: newest for recent reviews or relevance for the platform's relevance order. Reviews default to newest. On profile, the same name can affect attached review data but does not sort the single place object.
Allowed values:newestrelevance

How to use the Google Maps Reviews API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
  4. 04Store the structured response fields needed by your application.
google_maps_reviews_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'

Google Maps Reviews guides

Worked examples and methods built on these actions. Check the current actions, parameters and fields on this page first; an article's examples and limits do not replace the live catalog.

Build

Google Maps Reviews API: Selecting the Right Entry Point and Recording Location Reviews

Distinguish between Business Profile, Places API, and EveryInfra location review retrieval, verify location identity, language, and time filters, preserve changes to ratings and merchant replies, and clarify sample, storage, and display boundaries.

Read the article →
Blog

Deduplicating Google Maps Store Data: Place ID Is Not a Permanent Business Identity

The same location can have multiple Place IDs, and IDs can change over time. Using official documentation, this guide discusses verification methods for chain store deduplication, internal entity mapping, relocation history, and false merges.

Read the article →
Build

Multiplatform Reputation Monitoring Blueprint: Define Scope Before Evaluating Negative Shifts

Design a traceable reputation monitoring workflow starting with target lists, comment identities, and incremental cursors; use offline samples to demonstrate deduplication and ingestion gaps while preserving manual review.

Read the article →

Google Maps Reviews API questions

What can I retrieve with the Google Maps Reviews API?

Set platform to google_maps_reviews. The current catalog lists search, place details, and reviews. These action names identify different Google Maps Reviews objects or views; they are not interchangeable search modes.

Which input starts a Google Maps Reviews `search` request?

A Google Maps place name, business type, or place query, such as dentist or dentist in Chicago. search finds places; it does not search the text of reviews for an existing business. Send it as keyword inside params.

Which fields can Google Maps Reviews `search` return?

Its declared schema includes place_id, name, category, and categories. A declared field can still be absent from an individual record, and every other action has its own field list.

Does every Google Maps Reviews action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.