Batch get reviews
Fetches reviews across multiple locations in a single request.
More efficient than calling GET /gmb-reviews per location for multi-location businesses.
Returns a flat locationReviews array (not grouped by location): each item carries
the location resource name it belongs to (name) plus the review object (review),
whose identity is review.reviewId.
Reviews are requested from Google ordered by orderBy (default updateTime desc,
newest first), so callers polling for recent reviews can stop paginating once they
cross their date window.
Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount).
For those, use the single-location GET /gmb-reviews endpoint.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests.
1 <= items <= 50Number of reviews per page (max 50)
501 <= value <= 50Pagination token from previous response
1 <= lengthSort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.
"updateTime desc""updateTime desc" | "rating" | "rating desc"Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.accounts.batchGetGoogleBusinessReviews({ path: { accountId: 'account_abc123', }, body: { locationNames: [ 'Example', ], },});console.log(data);{
"success": true,
"accountId": "string",
"locationReviews": [
{
"name": "string",
"review": {}
}
],
"nextPageToken": "string"
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}Get a review GET
Returns one Google Business review, in the same shape as the entries of GET /v1/accounts/{accountId}/gmb-reviews. The review is read from the account's selected location unless locationId overrides it, and Google returns 404 for a review id that belongs to another location. Read the review before replying if a human may have answered it already: replies are overwritten in place and Google keeps no history.
Reply to a review POST
Posts (or updates) the business owner reply to a Google Business review. The reply is associated with the account's currently selected location (set via /v1/accounts/{accountId}/gmb-locations). Calling this endpoint a second time on the same review overwrites the previous reply (PUT semantics on Google's side). Google keeps no history, so an automated retry silently replaces a reply someone edited by hand in the Google Business Profile UI. Read the review before retrying if a human may have answered it.