Accounts

The Google My Business APIs, which the Featurable API utilizes, organizes business listings in a two-level hierarchy. At the top level are accounts. Your Google account may have multiple Google My Business accounts, each of which may have multiple locations. The accounts endpoint allows you to list all accounts associated with your Google account.

To ultimately fetch reviews for a business location, we will need the account ID and location ID.

The account model

The Account object represents a Google My Business account associated with the user. Accounts are private top-level entities used for access control and ownership management.

Properties

Name
accountId
Type
string
Description
Unique identifier for the account.
Name
accountOwner
Type
string
Description
Name of the account, typically your Google username.
Name
accountType
Type
string
Description
Type of the account (e.g. "PERSONAL" or "ORGANIZATION")
Name
avatar_url
Type
string
Description
The avatar image URL for the contact.

GET/v1/accounts

List all accounts

This endpoint allows you to retrieve a list of all your accounts. You can then use the accountId to list all locations associated with the account.

Request

GET

/v1/accounts

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

Response

{
  "success": true,
  "accounts": [
    {
      "accountId": "WAz8eIbvDR60...",
      "accountName": "John Smith",
      "accountType": "PERSONAL",
    },
    {
      "accountId": "hSIhXBhNe8X1..."
      // ...
    }
  ]
}