Retrieve live Google Business Profile reviews for one or more connected locations, including the review text, star rating, reviewer name, and any reply already posted.

Reviews are read from Google at request time, so they reflect the current state of the profile rather than a Local Falcon snapshot.

Pagination. When more reviews exist than the requested limit, the response returns a next_token. Pass that value back as next_token on the following request to retrieve the next page. On the final page next_token is returned as false. The token in a response always points at the next page, so continue until next_token is false rather than comparing tokens.

Filtering. unanswered and rating are applied after the reviews are read from Google, so a filtered page may require several reads to fill. A filtered request walks up to 10 pages of Google results before returning what it has found.

Single review. Supplying review_id returns just that review and ignores limit, unanswered, rating, and next_token.

Multiple locations. place_id accepts up to 10 comma separated Place IDs. Each location is returned as its own entry under locations, and a location that fails returns error and message on its own entry rather than failing the whole request. next_token can only be used with a single Place ID.