Reviewflowz API Get an API key
Platforms

Google Maps reviews with the Reviewflowz API

Add any Google Maps listing and read its reviews as JSON, kept up to date, with the reviewers' photos, the business's replies, and every edit and removal. Connect the listing's Google Business Profile in the app and replies post to Google too.

Run calls

Sign in to run every call on this page on your account's data. No key needed.

At a glance

What On Google Maps
Add by URL or name
First import The newest 4,000, or your plan's history limit if lower. Connected: the listing's whole history.
Extra fields Photos, link to the review
Ratings Google's score and review count, with history in GET /v3/ratings/history. The star split comes with it when the listing is not connected.
Edits and removals Both tracked
Replies Read; post when connected
Connection Google Business Profile
Review link Yes, with GET /v3/review-link

Add a source

Any of these URLs adds the same Google Maps page:

  • https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8
    The short link from Share in the Maps app.
  • https://share.google/tK8BhKGOGxqzquwo7
    The link from Share in Google Search.
  • https://www.google.com/maps/place/Eiffel+Tower/@48.8583701,2.2919064,16z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0!8m2!3d48.8583701!4d2.2944813
    The full place URL from the browser's address bar.
  • https://www.google.com/maps/place/?q=place_id:ChIJLU7jZClu5kcR4PcOOO6p3I0
    A place id.
  • https://www.google.com/maps?cid=10222232094831998944
    A CID, the numeric id Google uses inside Maps.
  • https://www.google.com/travel/hotels/entity/CgoI-_ma-dnp3bpNEAE
    A hotel's page in Google Travel.

Send it to POST /v3/sources. Prefer: wait=25 waits up to 25 seconds for the first import, and the answer gives the source's id (src_4812 here).

curl https://api.reviewflowz.com/v3/sources \-H "Authorization: Bearer rfz_live_..." \-H "Content-Type: application/json" \-H "Prefer: wait=25" \-d '{"urls": ["https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8"]}'
Edit the request

POST /v3/sources in the reference

Find a page by name

Don't have the URL? GET /v3/lookup searches Google Maps by name and returns candidate pages, best match first.

curl "https://api.reviewflowz.com/v3/lookup?q=Tour%20Eiffel%20Paris&platform=google_maps&country=FR" \-H "Authorization: Bearer rfz_live_..."
Edit the request

GET /v3/lookup in the reference

Read reviews

Up to 500 a page, newest found first.

curl "https://api.reviewflowz.com/v3/reviews?source=src_4812&limit=500" \-H "Authorization: Bearer rfz_live_..."
Edit the request

GET /v3/reviews in the reference

Example answer
{"data": [{"id": "rev_918273","source": "src_4812","platform": "google_maps","location": null,"rating": 5,"text": "Booked the summit tickets online and skipped the whole queue. The view at sunset was worth every euro, and the staff on the second floor were patient with our kids.","language": "en","reviewer": {"name": "Maya Chen"},"url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnTURRazh2cG5RRRAB","date": "2026-11-09T18:32:00Z","removed": false,"removed_at": null,"previous_version": null,"root_review": "rev_918273","latest_version": true,"created_at": "2026-11-10T08:40:09Z"}],"next_cursor": "eyJpZCI6OTE4MjczfQ","has_more": true}

Shortened: each review also has tags, owners, owner_suggestions and topics. Pass next_cursor back as cursor for the next page.

Fields

Field Type What it holds
id string The review's id.
rating number The star rating.
text string What the reviewer wrote.
language string ISO 639-1 code of the text.
reviewer.name string The reviewer's public Google name.
reviewer.avatar_url string The reviewer's Google profile photo, when the listing is not connected.
url string The review on the platform.
date date-time When it was posted on the platform.
media object Photos the reviewer attached, with include=media. Videos too when the listing is connected.
removed boolean True once the platform no longer shows the review.
removed_at date-time When it was found missing.
previous_version string The version an edit replaced, or null.
root_review string The first version of the review.
latest_version boolean True on the newest version.
created_at date-time When Reviewflowz found it.

New reviews

  • Each review found after the first import is sent as review.created.

Each new review becomes a review.created event within about two minutes of being found, POSTed to the endpoints you subscribe, signed. This is the body your endpoint receives:

{"id": "evt_4821","type": "review.created","timestamp": "2026-11-10T08:40:09Z","data": {"object": {"id": "rev_918273","source": "src_4812","platform": "google_maps","location": null,"rating": 5,"text": "Booked the summit tickets online and skipped the whole queue. The view at sunset was worth every euro, and the staff on the second floor were patient with our kids.","language": "en","reviewer": {"name": "Maya Chen"},"url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnTURRazh2cG5RRRAB","date": "2026-11-09T18:32:00Z","removed": false,"removed_at": null,"previous_version": null,"root_review": "rev_918273","latest_version": true,"created_at": "2026-11-10T08:40:09Z"},"source": "src_4812"}}

Set up an endpoint and check signatures: Webhooks.

Edits and removals

  • Edits. A review its author changes comes back as a new version: previous_version points to the one it replaced and latest_version is true on the newest. GET /v3/reviews returns the latest versions; add versions=all for every version. Each edit sends review.updated.
  • Removals. A review that Google no longer shows gets removed: true and removed_at, and sends review.removed. With a connection, every review is checked. Without one, only the newest reviews, the ones each refresh reads, are checked.
  • A removed review that Google shows again goes back to removed: false and sends review.reinstated.

Replies

  • The business's reply on Google comes back with include=reply, with origin: "platform", whether the listing is connected or not.
  • POST /v3/reviews/{id}/reply with publish: true posts to Google when the listing is connected.
  • Google refuses replies from a login that can't reply on the location, or on a listing that isn't claimed. The call then answers 502 publish_failed with Google's reason.
  • Without a connection, publish: true answers 409 not_repliable. Save the reply with publish: false and post it from Google Business Profile.

Connection

Connect the Google Business Profile that manages the listing in the Reviewflowz app, under Integrations. Nothing in the API changes: the same source gets the connected behaviour.

Without a connection With Google Business Profile connected
First import The newest 4,000, or your plan's history limit if lower The whole history
Removals The newest reviews The whole history
Edits Yes Yes
Star split Yes No
Reviewer photo URL Yes No
Videos No Yes
Replies Read; draft Read; post to Google

If the login loses access, the source keeps refreshing from the public listing. While it does, no review is marked removed and replies can't be posted; reconnect in the app to go back.

Good to know

  • A source's first import sends no review.created: only reviews found after it do.
  • POST /v3/sources/{id}/sync fetches at once when the source's last check is old enough, and answers 429 sync_too_soon with Retry-After before.
  • Only Google Maps listings are covered, not Google Shopping product reviews.

Questions

Can I read reviews of a listing I don't manage?

Yes. Any public Google Maps listing can be added with POST /v3/sources. A connection is only possible for listings your Google login manages.

How do I get reviews older than the newest 4,000?

Connect the listing's Google Business Profile in the app: the connected import reads its whole history.

Errors and access

A URL we can't read comes back in rejected with a reason, and every error is JSON with a code to branch on: Errors and limits.

The API is part of the Premium plan (see pricing). API-only plans start at $300 a month: book a 30-minute call for a custom quote.

Reviewflowz is an independent service. This is not Google's API and Reviewflowz is not affiliated with Google.