Reviews

After retrieving your accountId and locationId using the account and location endpoints, you are ready to fetch reviews for a business listing. Using the Featurable API, you can list all your reviews for any business you manage on Google My Business.

The `Review` model

The Review object represents a review left by a customer on a Google My Business listing. Reviews are public entities that can be retrieved and displayed on your website or application.

Name
reviewId
Type
string
Description
Unique identifier for the review.
Name
reviewer
Type
Reviewer
Description
Object representing the author of the review.
Name
starRating
Type
number
Description
Star rating of the review from 1 to 5.
Name
comment
Type
string
Description
Plaintext body of the review.
Name
createTime
Type
string
Description
Timestamp of when the review was created.
Name
updateTime
Type
string
Description
Timestamp of when the review was last updated.
Name
reviewReply
Type
ReviewReply
Description
Object representing the business owner's reply to the review (if it exists)

The `Reviewer` model

The Reviewer object represents the author of a review left on a Google My Business listing.

Name
displayName
Type
string
Description
Name of the reviewer.
Name
profilePhotoUrl
Type
string
Description
URL to the reviewer's profile photo.
Name
isAnonymous
Type
boolean
Description
Whether the reviewer is anonymous.

The `ReviewReply` model

The ReviewReply object represents a reply left by the business owner in response to a customer review.

Name
comment
Type
string
Description
Plaintext body of the reply.
Name
updateTime
Type
string
Description
Timestamp of when the reply was last updated.

GET/v1/accounts/:accountId/locations/:locationId/reviews

List all reviews

This endpoint allows you to retrieve a list of all reviews for a specified Google My Business location.

Request

GET

/v1/accounts/:accountId/locations

curl -G https://featurable.com/api/v1/accounts/:accountId/locations \
  -d apiKey=YOUR_API_KEY

Response

{
  "success": true,
  "reviews": [
    {
      "reviewId": "WAz8eIbvDR60...",
      "reviewer": {
        "displayName": "John Smith",
        "profilePhotoUrl": "https://google.com/...",
        "isAnonymous": false,
      },
      "reviewReply": {
        "comment": "Thank you for your review!",
        "updateTime": "2025-09-01T12:00:00Z",
      },
      "createTime": "2025-09-01T12:00:00Z",
      "updateTime": "2025-09-01T12:00:00Z",
      "comment": "Great service, will come back again!",
    },
    {
      "reviewId": "hSIhXBhNe8X1..."
      // ...
    }
  ]
}