Google Business

List Google Business Profile reviews

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.

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

Query parameters

workspace_idstring
account_idinteger
location_idstring
ratinginteger
unansweredboolean
limitinteger

Maximum reviews to return in this response.

offsetinteger

Number of matching reviews to skip before returning results.

Response

Google Business reviews fetched successfully

reviewsobject[] required
totalinteger required

Reviews matching the filters across every page, not just the ones returned.

returnedinteger

Number of reviews in this response.

limitinteger
offsetinteger
has_moreboolean

True when more matching reviews remain past this page.

fetchedinteger

Reviews fetched from Google before rating/unanswered filters were applied.

total_review_countinteger nullable

Google's own review count summed across the selected locations, or null when Google did not report one.

Example response

{
  "reviews": [
    {
      "name": "accounts/123/locations/456/reviews/abc",
      "starRating": 5,
      "comment": "Great service.",
      "reviewer": {
        "displayName": "Alex"
      },
      "createTime": "2026-05-16T10:00:00Z",
      "locationId": "456",
      "account_id": 123
    }
  ],
  "total": 81,
  "returned": 81,
  "limit": 200,
  "offset": 0,
  "has_more": false,
  "fetched": 81,
  "total_review_count": 81,
  "locations": [
    {
      "id": 123,
      "location_id": "456",
      "name": "Downtown",
      "business_name": "Downtown Cafe",
      "total_review_count": 81,
      "average_rating": 4.6,
      "fetched_review_count": 81,
      "error": null
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.