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

# List Business Profile Reviews

`POST /v2/gbp/reviews/`

## Request

- Base URL: `https://api.localfalcon.com`
- URL: `https://api.localfalcon.com/v2/gbp/reviews/`
- Auth: none declared

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.

## Request body `application/x-www-form-urlencoded`

- object
  - `api_key` string, required: Your Local Falcon API key.
  - `place_id` string, required: The Place ID of a connected location. Up to 10 comma separated Place IDs may be supplied.
  - `review_id` string: Retrieve a single review by its ID. When supplied, all other filter and pagination parameters are ignored.
  - `limit` integer: The number of reviews you wish to retrieve per location.
  - `unanswered` boolean: Only return reviews that do not yet have a reply.
  - `rating` string: Comma separated star ratings to include, from 1 to 5. For example, `1,2` returns only one and two star reviews.
  - `next_token` string: This parameter is used to get the next 'page' of results. The value used with the parameter is provided from a previous response by this endpoint if more 'pages' of results exist. 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` string: The average rating across every review on the profile, formatted to three decimal places. Returned as a string.
      - `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.

## Changes

- **2026-09-03** `85390c3f81cf`: 2 info
  - api tag `Manage Google Business Profile` added
  - api tag `Google Business Profile` removed
- **2026-09-02** `ad66f8884700`: 1 breaking
  - the `data/locations/items/average_rating` response's property type changed from `number` to `string` for status `200`
- **2026-08-20** `5487f4bd451b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/localfalcon/apis/local-falcon-api/changes/v2/gbp/reviews/post.md)

---

[API](https://skmtc.dev/localfalcon/apis/local-falcon-api.md) - [All operations](https://skmtc.dev/localfalcon/apis/local-falcon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/localfalcon/apis/local-falcon-api/revisions/304db93dea96?raw)