---
title: "Batch get reviews"
method: POST
path: "/v1/accounts/{accountId}/gmb-reviews/batch"
tags: ["GMB Reviews"]
---

# Batch get reviews

`POST /v1/accounts/{accountId}/gmb-reviews/batch`

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.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `locationNames` string[], required — 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.
  - `pageSize` integer — Number of reviews per page (max 50)
  - `pageToken` string — Pagination token from previous response
  - `orderBy` 'updateTime desc' | 'rating' | 'rating desc' — Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.

## Response `200`

Batch reviews fetched successfully

- object
  - `success` boolean
  - `accountId` string
  - `locationReviews` object[]
    - `name` string — LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name).
    - `review` object — The review object: reviewId (the review's identity), name (full review resource name, accounts/*/locations/*/reviews/*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl)
  - `nextPageToken` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/a23bb6e63438/schema)