Get reviews
Returns reviews for a Google Business Profile account including ratings, comments, and owner replies. Use nextPageToken for pagination.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Path Parameters
The Zernio account ID (from /v1/accounts)
Query Parameters
Override which location to query. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.
Number of reviews to fetch per page (max 50)
1 <= value <= 5050Pagination token from previous response
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
{ "success": true, "accountId": "64e1f0a9e2b5af0012ab34cd", "locationId": "9281089117903930794", "reviews": [ { "id": "AIe9_BGx1234567890", "name": "accounts/123456789/locations/9281089117903930794/reviews/AIe9_BGx1234567890", "reviewer": { "displayName": "John Smith", "profilePhotoUrl": "https://lh3.googleusercontent.com/a/...", "isAnonymous": false }, "rating": 5, "starRating": "FIVE", "comment": "Great service and friendly staff! Highly recommend.", "createTime": "2024-01-15T10:30:00Z", "updateTime": "2024-01-15T10:30:00Z", "reviewReply": { "comment": "Thank you for your kind words! We appreciate your support.", "updateTime": "2024-01-16T08:00:00Z" }, "photoCount": 0, "photos": [] }, { "id": "AIe9_BGx0987654321", "name": "accounts/123456789/locations/9281089117903930794/reviews/AIe9_BGx0987654321", "reviewer": { "displayName": "Anonymous", "profilePhotoUrl": null, "isAnonymous": true }, "rating": 4, "starRating": "FOUR", "comment": "Good experience overall.", "createTime": "2024-01-10T14:20:00Z", "updateTime": "2024-01-10T14:20:00Z", "reviewReply": null, "photoCount": 0, "photos": [] } ], "averageRating": 4.5, "totalReviewCount": 125, "nextPageToken": "CiAKHAoUMTIzNDU2Nzg5"}Start an evaluation run
Simulates the given scenarios against the agent and scores them. Answers 202 with a `job_id` to poll with GET.
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.