Get reviews

Returns reviews for a GBP account including ratings, comments, and owner replies. Use nextPageToken for pagination.

GET /v1/accounts/{accountId}/gmb-reviews

Returns reviews for a GBP account including ratings, comments, and owner replies. Use nextPageToken for pagination.

Parameters

• accountId (path, string) required — The Zernio account ID (from /v1/accounts)

• locationId (query, string) — Override which location to query. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.

• pageSize (query, integer) — Number of reviews to fetch per page (max 50)

• pageToken (query, string) — Pagination token from previous response

Responses

200 — Reviews fetched successfully

• success (boolean)
• accountId (string)
• locationId (string)
• reviews (array)
• averageRating (number) — Overall average rating
• totalReviewCount (integer) — Total number of reviews
• nextPageToken (string) — Token for next page

400 — Invalid request - not a Google Business account or missing location

• error (string)
• details (object)

401 — Unauthorized or token invalid

• error (string)
• details (object)

403 — Permission denied for this location

• error (string)
• details (object)

404

500 — Failed to fetch reviews

• error (string)
• details (object)