At a glance
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"]}'
const res = await fetch("https://api.reviewflowz.com/v3/sources", {method: "POST",headers: {"Authorization": "Bearer rfz_live_...","Content-Type": "application/json","Prefer": "wait=25",},body: JSON.stringify({"urls": ["https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8"]}),});console.log(await res.json());
import requestsres = requests.post("https://api.reviewflowz.com/v3/sources",headers={"Authorization": "Bearer rfz_live_...","Content-Type": "application/json","Prefer": "wait=25",},json={"urls": ["https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8"]},)print(res.json())
Edit the request
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_..."
const res = await fetch("https://api.reviewflowz.com/v3/lookup?q=Tour%20Eiffel%20Paris&platform=google_maps&country=FR", {method: "GET",headers: {"Authorization": "Bearer rfz_live_...",},});console.log(await res.json());
import requestsres = requests.get("https://api.reviewflowz.com/v3/lookup",headers={"Authorization": "Bearer rfz_live_...",},params={"q": "Tour Eiffel Paris", "platform": "google_maps", "country": "FR"},)print(res.json())
Edit the request
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_..."
const res = await fetch("https://api.reviewflowz.com/v3/reviews?source=src_4812&limit=500", {method: "GET",headers: {"Authorization": "Bearer rfz_live_...",},});console.log(await res.json());
import requestsres = requests.get("https://api.reviewflowz.com/v3/reviews",headers={"Authorization": "Bearer rfz_live_...",},params={"source": "src_4812", "limit": "500"},)print(res.json())
Edit the request
- platform · Comma-separated platform ids.
- rating · Star ratings, comma-separated: rating=1,2 (4 includes 4.5).
- date_after · Posted on the platform at or after.
- updated_after · Catch up after downtime: reviews found, edited, removed,...
- cursor · The next_cursor from the previous page. Leave it out for the first...
- id · Comma-separated review ids: id=rev_1 reads one review.
- location · Comma-separated location ids.
- product · Comma-separated product ids (accounts that group sources into...
- dimension[key] · Reviews of sources with this custom dimension value...
- rating_min · Scores of at least this: rating_min=4.
- rating_max · Scores of at most this: rating_max=3 (3.5 is out).
- date_before
- created_after · Found by Reviewflowz at or after.
- created_before
- source_created_after · Reviews of sources added at or after (bulk imports).
- tag · Comma-separated tag ids.
- owner · Comma-separated owner ids (confirmed assignments).
- topic · Comma-separated topic names.
- subtopic · Comma-separated subtopic names. With topic or sentiment, the same...
- sentiment · With topic, a mention of that topic with that sentiment.
- has_reply
- removed
- language · Comma-separated ISO 639-1 codes.
- country · The reviewer's country, where the platform gives one:...
- q · Full-text search (title, text, pros, cons, reviewer); every word...
- keywords · Like q, but any of the words: keywords=refund,late.
- has_text · Reviews with written text (true) or a rating alone (false).
- text_length_min · At least this many characters of text.
- versions · latest lists only the current version of an edited review; all...
- include · Any of media, reply, events, comma-separated.
- fields · Only these top-level fields (id always comes).
- columns · Comma-separated export columns (rating, date, reviewer,...
- sort · created: newest found first. date: newest posted on the platform...
GET /v3/reviews in the reference
Example answer
Shortened: each review also has tags, owners, owner_suggestions and topics. Pass next_cursor back as cursor for the next page.
Fields
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_versionpoints to the one it replaced andlatest_versionis true on the newest.GET /v3/reviewsreturns the latest versions; addversions=allfor every version. Each edit sendsreview.updated. - Removals. A review that Google no longer shows gets
removed: trueandremoved_at, and sendsreview.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: falseand sendsreview.reinstated.
Replies
- The business's reply on Google comes back with
include=reply, withorigin: "platform", whether the listing is connected or not. POST /v3/reviews/{id}/replywithpublish: trueposts 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_failedwith Google's reason. - Without a connection,
publish: trueanswers 409not_repliable. Save the reply withpublish: falseand 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.
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}/syncfetches at once when the source's last check is old enough, and answers 429sync_too_soonwithRetry-Afterbefore.- 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.