Skip to content

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. Reviews are grouped by location in the response.

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. Reviews are grouped by location in the response.

Parameters

  • accountId (path, string) required

Request body

Content-Type: application/json

  • locationNames (array) required — Array of full location resource names (e.g. ['accounts/123/locations/456'])
  • pageSize (integer) — Number of reviews per page (max 50)
  • pageToken (string) — Pagination token from previous response

Example:

json

{
  "locationNames": [
    "accounts/123/locations/456",
    "accounts/123/locations/789"
  ],
  "pageSize": 50
}

Responses

200 — Batch reviews fetched successfully

  • success (boolean)
  • accountId (string)
  • locationReviews (array)
  • nextPageToken (string)

400 — Invalid request

  • error (string)
  • details (object)

401 — Unauthorized

  • error (string)
  • details (object)