---
title: "List Google Business Profile reviews"
method: GET
path: "/api/v1/google-business/reviews"
tags: ["Google Business"]
---

# List Google Business Profile reviews

`GET /api/v1/google-business/reviews`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/google-business/reviews`
- Auth: HTTP bearer

Fetch reviews for one Google Business Profile account/location or every accessible GBP location in a workspace. Pages through every review Google holds for each location (Google caps its own page at 50) and returns the full review text with its `createTime`. Ratings are normalized to numeric 1-5 values. Use `limit`/`offset` to page through the result set; `has_more` tells you when more remain.

## Query parameters

- `workspace_id` string
- `account_id` integer
- `location_id` string
- `rating` integer
- `unanswered` boolean
- `limit` integer
- `offset` integer

## Response `200`

Google Business reviews fetched successfully

- GoogleBusinessReviewsResponse
  - `reviews` object[], required
  - `total` integer, required: Reviews matching the filters across every page, not just the ones returned.
  - `returned` integer: Number of reviews in this response.
  - `limit` integer
  - `offset` integer
  - `has_more` boolean: True when more matching reviews remain past this page.
  - `fetched` integer: Reviews fetched from Google before rating/unanswered filters were applied.
  - `total_review_count` integer, nullable: Google's own review count summed across the selected locations, or null when Google did not report one.
  - `locations` object[], required
    - `id` integer
    - `location_id` string, nullable
    - `name` string, nullable
    - `business_name` string, nullable
    - `workspace_id` string, nullable
    - `total_review_count` integer, nullable: Google's review count for this location.
    - `average_rating` number, nullable: Google's average rating for this location.
    - `fetched_review_count` integer: Reviews successfully fetched from this location.
    - `error` string, nullable: Why this location's reviews are missing or incomplete. Null when the location synced cleanly, so an empty result with a null error means the location genuinely has no reviews.

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `404`: Resource not found
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)