Overview

Google My Business provides a fast and easy way for businesses, products, brands, artists, and organizations to manage their online presence with Google.

The Google My Business API is a programming interface that allows developers to write applications to manage Google My Business account and location data. The Google My Business API supports a subset of the features available on the Google My Business Interface. For the features that are available in the API, all functionality and quality guidelines are the same as that of the full interface.

Developers who want to write applications to manage Google My Business data and developers who use the AdWords API to manage manual Location Extensions should consider signing up for the Google My Business API.

The Google My Business API allows merchants or their representatives to manage how their data is presented across Google and who co-manages their data. User-created data can be managed through the API, including owner photos and reviews.

To retrieve local business information and provide location awareness to end users, see the documentation for the Places API. To manage existing Google+ +Pages and engage with social content, see the Google+ Pages Partner API.

Google My Business accounts and location groups

Changes made through the Google My Business API appear immediately in your Google My Business account.

Business owners

To share access to a large set of locations with a group of people, you can create location groups. Business owners who manage only a few locations don't need to create a location group. However, if you manage a large number of locations or are currently sharing your username and password with other users, you should transition to using location groups as a safer way to work together.

Agencies and third parties

If your client already has a Google My Business account, they can add your agency account as a manager to their individual locations or to their location group. If they don't already have a Google My Business account, they should create one (and a location group, if necessary) and add your agency as a manager to their individual locations or to their location group.

Third parties should not request access to the API on behalf of their clients. A single project ID is used for their entire application. Once a client has invited you to an existing location group, you can access their account through your generated OAuth2.0 token.

API functionality

Using the Google My Business API offers much of the same functionality as the Google My Business user interface, plus some additional features specific to the API. API users can expect Google updates to occur just as they do for users of the user interface. For more information on Google updates, see Manage Google updates.

Rate limit restrictions apply to the Google My Business API. For more information, see Usage Limits.

Testing and verification

The Google My Business API allows you to read location groups using the API, but not create them. You must sign in to the Google My Business interface to create a location group. The Google My Business API does not support location verification. Locations must be verified individually or through bulk verification if you own more than ten locations of the same business.

Only one project per business can be whitelisted. Testing with unverified locations must be performed in your primary project.

Listing setup

The Google My Business API allows you to see your listing state and any updates Google has made to your listing.

Latitude and longitude

To set up your listing, provide Google with the latitude and longitude for new locations to help us place them on the map. We'll only use latitude and longitude when we have trouble locating your address and won't be considered if they're included in subsequent update calls for existing locations. Latitude and longitude details must be edited using the Google My Business user interface.

Attributes

The mandatory listing fields for the Google My Business API are the same as the mandatory fields found in the Google My Business user interface. For more information, see Guidelines for representing your business on Google.

You can use the Google My Business API to provide additional attributes about your business beyond the core GMB attributes. Additional attributes cannot be added through the Google My Business user interface. Attributes are based on business category. For example, for restaurants you may see things like "serves breakfast." The attributes.list method can be used to get a list of attributes for a given category or country.

Attributes may not show up on Google surfaces like Maps or Search after you've updated them. However, providing these attributes helps Google develop future local search experiences and better understand your business. We’re currently working on building consumer experiences around these additional attributes, and you can expect some attributes to start showing on Google soon. Providing attributes can also help Google better understand your business and match your listing to relevant searches.

Manage listing details

Changes you make using the Google My Business API may not be reflected immediately. Changes made to unverified locations only appear in the Google My Business interface and can be used in Google Ads location extensions.

Edits made to verified business locations are eligible to appear on other Google products and may be subject to review to ensure that they adhere to the Google My Business quality guidelines and the Google+ content policy. Users who haven't been bulk verified can create and manage up to 100 Google+ pages per Google Account.

Special hours

Google maintains a list of Holidays on Google that are considered to be potential holidays. Maps and Search warn users that a business location's hours may differ on these dates. You can choose to set special hours to let customers know your operating hours on these days.

Support

Any questions about the Google My Business API should be directed to the My Business API forum. The forum is actively monitored by the Google My Business API support team. Developers can also use the forum to search for issues and solutions posted by other developers. Answers to non-API questions about Google My Business can be found in the Google My Business Help Center.

Send feedback about...

Google My Business API
Google My Business API
Need help? Visit our support page.