Reviewflowz API Get an API key
Tools

Forecast a Google business

The same forecast for any business on Google Maps, yours or not, like the free calculator. Its reviews are fetched first, which takes a few seconds: send Prefer: wait=25 to get the answer in this call (200), or take the 202 and GET /forecasts/{id}. Each call counts toward the account's daily allowance (see /usage). Leave out any input to get the default.

Requires analytics:read.

Run calls

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

Parameters

wait=N (up to 25): wait up to N seconds for the work to finish. 200 if it did, 202 with the object in its current state if not.
Any unique string (a UUID works). Retrying with the same key within 24 hours replays the first response instead of running again.

Body

url string Required
The business on Google Maps.
target_rating number
reviews_per_month number
new_reviews_rating number
days integer
The body you send, as JSON
curl https://api.reviewflowz.com/v3/forecasts \-H "Authorization: Bearer rfz_live_..." \-H "Content-Type: application/json" \-d '{"url": "https://maps.app.goo.gl/AbCdEf123","target_rating": 4.5,"reviews_per_month": 4.5,"new_reviews_rating": 4.5,"days": 1}'
Example answer
{"id": "fc_8b6f2d1e-5a43-4c2b-9d0e-7f1a2b3c4d5e","status": "ready","source": null,"name": "Juniper Ridge Dental","platform": "google_maps","url": "https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8","created_at": "2026-11-01T09:00:00Z","current": {"rating": 4.612,"displayed_rating": 4.6,"review_count": 212},"last_30_days": {"review_count": 9,"average_rating": 4.89,"capped": false},"inputs": {"target_rating": 4.7,"reviews_per_month": 9,"new_reviews_rating": 4.9,"days": 90},"projection": {"rating": 4.645,"displayed_rating": 4.6,"outcome": "gap","reviews_needed": 33,"months_needed": 3.7}}