Errors
Errors use RFC 9457 problem details. Branch on code, and quote request_id if you contact us.
{"type": "https://api.reviewflowz.com/v3/errors#invalid_parameter","title": "Bad Request","status": 400,"code": "invalid_parameter","detail": "limit: Use a whole number from 1 to 500.","request_id": "8c1f4e2a-93b7-4d0e-a6f5-2b9d7c3e1a40","errors": [{ "field": "limit", "code": "invalid", "detail": "Use a whole number from 1 to 500." }]}
Pagination
Lists return data, next_cursor and has_more. Pass next_cursor back as cursor to get the next page. limit goes up to 500.
curl "https://api.reviewflowz.com/v3/reviews?limit=500&cursor=eyJpZCI6OTE4MjczfQ" \-H "Authorization: Bearer rfz_live_..."
Rate limit
300 requests a minute per account. Past it you get 429 with Retry-After, the seconds to wait.
Safe retries
Send Idempotency-Key on a POST. Retrying with the same key within 24 hours returns the first answer instead of running again.
curl https://api.reviewflowz.com/v3/sources \-H "Authorization: Bearer rfz_live_..." \-H "Idempotency-Key: 6f1c2b7e-batch-1" \-H "Content-Type: application/json" \-d '{"urls": ["https://maps.app.goo.gl/Gjo5NDggCfPg8EWL8"]}'
Versions
Send Reviewflowz-Version: 2026-10-29 to pin one. Every answer says which version replied.
Error codes
The code of an error answer.
Why a URL was rejected
The reason of a URL in rejected, when the call itself succeeded.