Locations

After identifying your Google My Business accountId, using the List accounts endpoint, you can fetch business locations. Locations are individual Google My Business profiles/listings, each of which has its own reviews and ratings.

To fetch a list of locations, you first need to specify an account ID. You can find the account ID by listing all accounts.

The location model

The Location object represents a Google My Business profile associated a particular business you manage. Locations are public entities that show up in Google search results and Google Maps. Locations are managed by an account and represent public Google My Business listings that can be reviewed by customers.

Properties

Name
locationId
Type
string
Description
Unique identifier for the location.
Name
languageCode
Type
string
Description
Language code of the business profile (e.g. "en")
Name
title
Type
string
Description
Name of the business
Name
websiteUri
Type
string
Description
Website URL of the business
Name
storefrontAddress
Type
string
Description
Physical address of the business (if available)

GET/v1/accounts/:accountId/locations

List all locations

This endpoint allows you to retrieve a list of all locations managed by an account. You can then use the locationId to fetch reviews for a specific 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,
  "locations": [
    {
      "locationId": "WAz8eIbvDR60...",
      "languageCode": "en",
      "title": "John's Pizza",
      "storefrontAddress": null,
      "websiteUri": "https://example.com"
    },
    {
      "locationId": "hSIhXBhNe8X1..."
      // ...
    }
  ]
}