Before you start
- No code needed for a BI tool or a sheet. For Power BI, Excel, Tableau, Qlik Sense, Domo or Looker Studio, create a connection in the app under Integrations → Data Sync: it feeds every review, rating and location to the tool. For a Google Sheet, connect Google Sheets under Integrations → Forward Reviews. The steps below are for your own warehouse.
- A key with
reviews:read,sources:readandwebhooks:write. - 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.
- Your review pages added as sources: steps 1 and 2 of Find and monitor reviews for any business.
The example follows the Eiffel Tower's reviews into your warehouse.
1. Copy everything once
Note the time, then page through every review, 500 a call. Pass next_cursor back as cursor until has_more is false. Reviews found while you page don't shift the pages.
curl "https://api.reviewflowz.com/v3/reviews?limit=500" \-H "Authorization: Bearer rfz_live_..."
const res = await fetch("https://api.reviewflowz.com/v3/reviews?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={"limit": "500"},)print(res.json())
Edit the request
- source · Comma-separated source ids.
- 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 location, title, pros, cons, language, reviewer, url, tags, owners and topics. Store each review under its root_review, and keep its id beside it. An edited review is a new version with a new id, and every version shares the root_review of the first. This list holds the latest version of each review only. Add versions=all to copy the earlier versions too.
2. Stay current
On your own schedule, ask for everything that changed since the start of your last run:
curl "https://api.reviewflowz.com/v3/reviews?updated_after=2026-11-12T00%3A00%3A00Z&limit=500" \-H "Authorization: Bearer rfz_live_..."
const res = await fetch("https://api.reviewflowz.com/v3/reviews?updated_after=2026-11-12T00%3A00%3A00Z&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={"updated_after": "2026-11-12T00:00:00Z", "limit": "500"},)print(res.json())
Edit the request
- source · Comma-separated source ids.
- 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.
- 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...
The answer has the reviews found, edited, removed, reinstated, replied to, tagged or given an owner since that time, in the shape of step 1, with next_cursor as before. Upsert each one on its root_review. The first time, send the time you noted in step 1. After that, send the time your previous run started, not when it ended: a review found while it ran comes again, and the upsert makes that harmless.
Or have each change sent to you as it happens. Subscribe a URL of yours to the events your table needs:
curl https://api.reviewflowz.com/v3/webhook-endpoints \-H "Authorization: Bearer rfz_live_..." \-H "Content-Type: application/json" \-d '{"url": "https://hooks.yourcompany.com/reviewflowz","events": ["review.created", "review.updated", "review.removed", "review.reinstated", "review.deleted", "review.tagged", "review.untagged", "source.deleted"]}'
const res = await fetch("https://api.reviewflowz.com/v3/webhook-endpoints", {method: "POST",headers: {"Authorization": "Bearer rfz_live_...","Content-Type": "application/json",},body: JSON.stringify({"url": "https://hooks.yourcompany.com/reviewflowz", "events": ["review.created", "review.updated", "review.removed", "review.reinstated", "review.deleted", "review.tagged", "review.untagged", "source.deleted"]}),});console.log(await res.json());
import requestsres = requests.post("https://api.reviewflowz.com/v3/webhook-endpoints",headers={"Authorization": "Bearer rfz_live_...","Content-Type": "application/json",},json={"url": "https://hooks.yourcompany.com/reviewflowz", "events": ["review.created", "review.updated", "review.removed", "review.reinstated", "review.deleted", "review.tagged", "review.untagged", "source.deleted"]},)print(res.json())
Edit the request
POST /v3/webhook-endpoints in the reference
Example answer
Keep the secret for step 4. Each event's data.object is the review as the API returns it at the moment it's sent: upsert it on its root_review, as in the poll. A source's first import sends no review.created: step 1 covers that history.
Polling or not, subscribe to review.deleted and source.deleted: they are how deleted reviews leave your table. A review.deleted names the review by id ({"id": "rev_...", "deleted": true}): delete the row with that id. A source.deleted names the source: delete every row of that source.
3. Apply edits and removals
Each review carries what you need to apply a change:
review.updated brings an edit, review.removed a removal, and review.reinstated sets removed back to false. The poll in step 2 lists the same reviews.
4. Make it safe
- Check the signature of every event with the
secretfrom step 2. Webhooks shows how, with code. - Skip an event you've handled. The same event can arrive twice. Keep each event's
id(evt_...) and ignore one you've seen. - Answer fast. Return
2xxat once and load the row after.
If your server was down, GET /v3/events lists the events sent, newest first, each with its deliveries. Narrow it with type= and created_after=:
curl "https://api.reviewflowz.com/v3/events?created_after=2026-11-10T00%3A00%3A00Z" \-H "Authorization: Bearer rfz_live_..."
const res = await fetch("https://api.reviewflowz.com/v3/events?created_after=2026-11-10T00%3A00%3A00Z", {method: "GET",headers: {"Authorization": "Bearer rfz_live_...",},});console.log(await res.json());
import requestsres = requests.get("https://api.reviewflowz.com/v3/events",headers={"Authorization": "Bearer rfz_live_...",},params={"created_after": "2026-11-10T00:00:00Z"},)print(res.json())
Edit the request
- type · One type or several, comma-separated.
- limit · Rows per page (default 50).
- cursor · The next_cursor from the previous page. Leave it out for the first...
GET /v3/events in the reference
Example answer
Shortened: each event also has its data, with the object as it is now, and its deliveries. A delivery whose status is exhausted never reached you: every try failed. Send it again:
curl https://api.reviewflowz.com/v3/events/evt_4821/redeliver \-H "Authorization: Bearer rfz_live_..." \-H "Content-Type: application/json" \-d '{"endpoint": "we_12"}'
const res = await fetch("https://api.reviewflowz.com/v3/events/evt_4821/redeliver", {method: "POST",headers: {"Authorization": "Bearer rfz_live_...","Content-Type": "application/json",},body: JSON.stringify({"endpoint": "we_12"}),});console.log(await res.json());
import requestsres = requests.post("https://api.reviewflowz.com/v3/events/evt_4821/redeliver",headers={"Authorization": "Bearer rfz_live_...","Content-Type": "application/json",},json={"endpoint": "we_12"},)print(res.json())
Edit the request
POST /v3/events/{id}/redeliver in the reference
Example answer
Leave out endpoint to send it to every active endpoint subscribed to that event. For a long outage, run the poll from step 2 from the time your server went down. Then apply the deletions this list shows with type=review.deleted,source.deleted.
An endpoint that was switched off comes back with PATCH /v3/webhook-endpoints/we_12 and {"status": "active", "replay": true}, which also sends every event it missed.
5. Get the columns of the CSV export
If your warehouse already loads the app's CSV export, ask for the same columns with columns=, or columns=all for every column your account has, custom dimensions included. With fields=id, each review is its id and those columns alone:
curl "https://api.reviewflowz.com/v3/reviews?updated_after=2026-11-12T00%3A00%3A00Z&fields=id&columns=rating,date,reviewer,review_profile,tags,reply_text,last_seen" \-H "Authorization: Bearer rfz_live_..."
const res = await fetch("https://api.reviewflowz.com/v3/reviews?updated_after=2026-11-12T00%3A00%3A00Z&fields=id&columns=rating,date,reviewer,review_profile,tags,reply_text,last_seen", {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={"updated_after": "2026-11-12T00:00:00Z", "fields": "id", "columns": "rating,date,reviewer,review_profile,tags,reply_text,last_seen"},)print(res.json())
Edit the request
- source · Comma-separated source ids.
- 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.
- limit · Rows per page (default 50).
- 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.
- sort · created: newest found first. date: newest posted on the platform...
GET /v3/reviews in the reference
Example answer
Each value is the cell a CSV export writes for that review. A column that no source of your account fills comes back null. An unknown key answers 400 invalid_parameter with the list of keys you can use.
What it costs and where it stops
- 500 reviews per page of
GET /v3/reviews, 100 events per page ofGET /v3/events. Rate limits. - A source's first import sends no
review.created: copy it with step 1. - A deleted source sends one
source.deletedfor all its reviews.