Zernio
Zernio
API Reference

Google Business Profile

Reviews

Get reviewsGETGet a reviewGETBatch get reviewsPOSTReply to a reviewPOSTDelete a review replyDELETE

Food Menus

Get food menusGETUpdate food menusPUT

Location Details

Get location detailsGETUpdate location detailsPUT

Services

Get servicesGETReplace servicesPUT

Verification

Get verification stateGETFetch verification optionsPOSTStart a verificationPOSTComplete a verificationPOST

Media

List mediaGETUpload photoPOSTDelete photoDELETE

Attributes

Get attributesGETUpdate attributesPUTGet attribute metadataGET

Place Actions

List action linksGETCreate action linkPOSTUpdate action linkPATCHDelete action linkDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Google Business Profile

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.

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

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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"}
Was this page helpful?

Get a review

Returns one Google Business Profile 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

Posts (or updates) the business owner reply to a Google Business Profile 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.

locationNames*array<>

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.

Items1 <= items <= 50
pageSize?integer

Number of reviews per page (max 50)

Range1 <= value <= 50
Default50
pageToken?string

Pagination token from previous response

Length1 <= length
orderBy?string

Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.

Default"updateTime desc"

Value in

  • "updateTime desc"
  • "rating"
  • "rating desc"