---
title: "List Business Profile Reviews"
method: POST
path: "/v2/gbp/reviews/"
tags: ["Google Business Profile"]
---

# List Business Profile Reviews

`POST /v2/gbp/reviews/`

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.

## Response `200`

Successful response

- object
  - `code` integer
  - `code_desc` union
    - string
    - boolean
  - `success` boolean
  - `message` union
    - string
    - boolean
  - `parameters` object
  - `data` object
    - `count` integer — The number of locations returned.
    - `locations` object[]
      - `place_id` string
      - `total_reviews` integer — The total number of reviews on the profile, before any filtering.
      - `average_rating` number
      - `count` integer — The number of reviews returned on this page.
      - `next_token` union — Token for the next page of results, or `false` when no further pages exist.
        - string
        - boolean
      - `error` union — Error code, present only when reviews for this location could not be retrieved.
        - string
        - boolean
      - `message` union — Error description, present only when reviews for this location could not be retrieved.
        - string
        - boolean
      - `reviews` object[]
        - `review_id` string
        - `rating` integer
        - `comment` string, nullable — The review text. Returned as `null` when the reviewer left a rating with no comment.
        - `reviewer` string
        - `reviewer_photo` string
        - `date_created` string
        - `date_updated` string
        - `reply` union — The reply currently posted to this review, or `false` when there is none.
          - string
          - boolean
        - `reply_date` union
          - string
          - boolean

## Other responses

- `400` — The request was malformed or missing required parameters.
- `401` — The API key is missing, invalid, or does not have permission for the requested resource.
- `429` — You have exceeded the rate limit. Please wait before making additional requests.
- `500` — An unexpected error occurred on the server. Please try again later.

---

[API](https://skmtc.net/localfalcon/apis/local-falcon-api.md) · [All operations](https://skmtc.net/localfalcon/apis/local-falcon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/localfalcon/local-falcon-api/revisions/5487f4bd451b/schema)