What people mean by a Google Maps reviews API

There is no single Google Maps reviews API. Two Google APIs return review data. The Places API gives public information about any place, including a few reviews. The Google Business Profile APIs give owners access to the reviews of locations they manage. They serve different purposes, and confusing them leads to projects that cannot deliver.

What the Places API returns

  • reviews: a list of reviews about the place, sorted by relevance; at most 5 can be returned.
  • rating: between 1.0 and 5.0, based on user reviews.
  • userRatingCount: the total number of reviews, with or without text.
  • Each review includes a rating, a publish time and, where available, a visit date truncated to year and month.

Field masks and billing tier

Place Details (New) requires a field mask, and Google says omitting it returns an error. The reviews field triggers the Place Details Enterprise + Atmosphere SKU, as does the AI review summary field. Check Google's current pricing before building anything that calls it at volume.

Source

Google's Place Details (New) documentation.

Place Details (New) (Google for Developers)

Policies you must follow

  • Do not pre-fetch, cache or store Places content beyond Google's allowed exceptions; place IDs can be stored indefinitely.
  • Attribute review authors using avatar, name and profile link when space allows; at minimum the avatar.
  • Give users access to the source review on Google Maps via the googleMapsUri.
  • Include a clear notice of how reviews are ordered and filtered.
  • Show Places data on a Google Map, or with the Google logo if no map.
Source

Google's Places API policies and attributions.

Policies and attributions for Places API (Google for Developers)

What that means in practice

With 5 reviews per place and storage restrictions, the Places API suits showing a few reviews next to a store on a website or app. It does not suit building a history of every review, analysing complaint trends or comparing stores over months.

Free review snapshot

Want this done for your own reviews?

No commitment. We use your details only to send your snapshot and follow up. Privacy policy

The Business Profile API for your own stores

For locations you own or manage, Google's Business Profile APIs let you list reviews per location, batch-get reviews across locations, and reply or delete replies. That is the route for complete review data of your own stores.

GBP API

The Google Business Profile reviews API for multi-location brands.

The google business profile reviews api for multi location brands

Competitor reviews

Competitor locations are not yours, so the Business Profile API does not apply, and the Places API gives only a handful of reviews under strict rules. Be wary of approaches that ignore these terms.

Competitors

Competitor review analysis.

Competitor review analysis

Design notes for developers

  • Store place IDs, not review content.
  • Request only the fields you need; the tier depends on them.
  • Show the ordering notice and author attribution.
  • Link each review to Google Maps.
  • Google recommends telling users when reviews are translated and that reviews are not verified by Google.
Source

Google's recommendations on translated and unverified reviews.

Policies and attributions for Places API (Google for Developers)

Choosing the right route

  • Show a few reviews on a store page: Places API.
  • Read, reply to and analyse all reviews of your stores: Business Profile API.
  • Download data for analysis: see our guide on downloading review data.

Common mistakes

  • Expecting all reviews from the Places API.
  • Caching review text against Google's policy.
  • No author attribution.
  • Requesting every field and paying the top tier.
  • Using the Places API for your own stores' full history.

Common questions

How many reviews does the Places API return?

At most 5 per place, according to Google's reference.

Can I store Places reviews?

Google's policies restrict caching and storing Places content; place IDs are the exception.

Which API gives all my reviews?

The Business Profile APIs, for locations you manage.

Does the Places API show review replies?

Google's reference fields we reviewed do not include owner replies.

Checklist

  • Purpose decided: display or analysis.
  • Correct API chosen.
  • Field mask set.
  • No caching beyond place IDs.
  • Attribution and ordering notice shown.

In short

The Places API returns up to 5 relevance-sorted reviews per place under strict caching and attribution rules, so it suits display, not analysis. For complete review data of your own stores, use the Business Profile APIs.

Doing this with Falcon

Falcon analyses the Google Maps reviews of a brand's locations and the Google Play reviews of its app, and runs competitor analysis of public reviews, covering ratings, rating mix, rating change, positive share, themes and cities. Ask us how review data is connected for your locations and competitors.