Skip to main content

Google Reviews API vs widgets: what’s actually available in 2026

By The Reviews Widget product team11 min read

There is no single "Google Reviews API". The Places API (New) returns up to five reviews for any public place, billed per request. The Business Profile API returns every review, but only for verified locations you manage and only after Google approves access. If you just want reviews on a website, a widget is usually faster and cheaper.

What the Google Reviews API actually is in 2026

When people search for a Google Reviews API, they usually mean one of two different products. Google has no endpoint called "reviews API" on its own. Review data lives inside two separate platforms with different rules, costs and audiences.

Google review data sources compared
OptionReviews returnedWho can use itCost
Places API (New) — Place DetailsUp to 5 per placeAnyone with a Cloud billing accountEnterprise + Atmosphere SKU, free monthly threshold
Business Profile API — reviews.listAll reviews, with owner repliesApproved projects, verified locations onlyNo per-request charge; approval required
Reviews widget (no code)Depends on provider and planAny website ownerFree tier or subscription
Manual copy and pasteWhatever you copyAnyoneFree, but goes stale

The Places API: five reviews, billed per request

The Places API (New) returns a reviews field in Place Details. It is open to any developer with a Google Cloud project, billing enabled and an API key. The catch is the limit: each request returns at most five reviews, ordered by Google's relevance.

Requesting reviews moves the call into the Enterprise + Atmosphere SKU, the highest Place Details tier. Since 1 March 2025 Google replaced the US$200 monthly credit with free usage thresholds per SKU, so a small site that caches well may stay within the free amount. Prices vary by volume tier, so check the live pricing page before you build.

What five reviews means in practice

  • You cannot show your full review history or newest reviews on demand.
  • Carousels built only on the Places API repeat the same reviews for weeks.
  • Owner replies are not included in Places review objects.
  • You must show Google attribution and follow the caching rules.

The Business Profile API: every review, but gated

The Business Profile API is the only official route to every review, including owner responses. The accounts.locations.reviews.list method pages through all reviews for a location you manage, and related methods let you reply.

Access is restricted. You must request API access for your Cloud project and show a legitimate business use, sign in with OAuth using the business.manage scope, and the location must be verified. It suits agencies and multi-location brands managing their own profiles, not quick website embeds.

Want reviews on your site today?

Connect your Google profile and get an embed snippet in minutes, with no API key or billing account.

What building it yourself involves

A custom integration with Google reviews JavaScript or HTML looks simple in a tutorial. In production, the work is in the parts around the request.

  1. Protect the key. Call the API from a server, or restrict the browser key by referrer and API.
  2. Cache within the terms. Store results to control cost, but follow Google's caching limits.
  3. Render accessibly. Build the layout, star ratings, read-more and mobile behaviour.
  4. Add attribution. Show Google's required attribution and reviewer links.
  5. Maintain it. Google retired the legacy Places API for new projects; future changes will need code updates.
The API call is the cheap part. The layout, caching, attribution and upkeep are where custom review integrations cost time.
— The real cost

How reviews widgets compare

A widget gives you working Google review embed code without touching an API. The provider fetches and refreshes reviews, handles layouts and gives you one snippet. The Google reviews widget from Reviews Widget offers grid, carousel, badge and other layouts, plus Trustpilot and other sources in the same feed.

API vs widget decision guide
Your situationBetter choice
Small business site, wants reviews this weekWidget
Site on Wix, Squarespace, Webflow or WordPressWidget
Developer building a custom app with review dataPlaces API
Agency managing many verified profiles and repliesBusiness Profile API
Needs reviews from several platforms togetherWidget

If you prefer to paste code by hand, the guide to embedding Google reviews in HTML walks through it step by step. Builders without code access can use the no-code embed instead.

Next steps

Start with the outcome you need. If it is reviews on a page, use a widget and spend the saved time collecting more genuine feedback with your Google review link. If you need review data in your own software, build on the Places API and plan for the five-review limit, or apply for Business Profile API access for profiles you own.

Either way, keep reviews genuine and attributed. Then place them where customers decide, as covered in where to place reviews on your website.

Sources & further reading

  • Google Reviews API
  • Places API
  • Embed code
  • Review widgets

Frequently asked questions

Is there a free Google Reviews API?+

There is no separate free reviews API. The Places API (New) returns reviews as part of Place Details, billed under the Enterprise + Atmosphere SKU. Since March 2025 each SKU has a free monthly usage threshold instead of the old US$200 credit, so low-volume projects may pay nothing, but a billing account is still required.

How many reviews does the Google Places API return?+

Place Details returns up to five reviews per place, chosen by Google's relevance ordering. You cannot page through the full review history with the Places API, which is why API-built carousels often show the same handful of reviews.

How do I get all my Google reviews through an API?+

The Google Business Profile API method accounts.locations.reviews.list returns every review for a location, including owner replies. It requires approved API access, OAuth with the business.manage scope and a verified location you manage.

Do I need an API key to embed Google reviews?+

Not if you use a reviews widget. The widget provider handles the data source and gives you an embed snippet to paste into your site. You only need your own API key if you build the integration yourself.

Can I write my own Google reviews JavaScript instead?+

Yes, but you must keep the API key server-side or restricted, cache responses within Google's terms, show required attributions and maintain the code when the API changes. For most business sites that maintenance outweighs the benefit.

Is Google review embed code available from Google itself?+

Google does not offer an official copy-and-paste review carousel for websites. Embed code for Google reviews comes from a widget provider or from a custom integration you build on the APIs.

Continue reading

Skip the API keys and billing setup

Create a free Reviews Widget and paste one snippet into your site. We handle the review data, refreshes and layouts.