Sign up for email announcements to stay updated on the latest information about the GMB API.

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.

We recommend that developers who want to write applications to manage their Google My Business data, and developers who use the AdWords API to manage manual Location Extensions, 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, such as owner photos and reviews, can be managed through the API.

To retrieve local business information and provide location awareness to end users, see the Google Maps Platform Documentation.

API functionality

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. Users of the API 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, but not create, location groups with the API. You must sign in to the Google My Business interface to create a location group. Locations must be verified individually or through bulk verification if you own more than 10 locations of the same business.

Only one project per business can be granted access to the Google My Business API. Testing with unverified locations must be performed in your primary project.

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 you currently share your username and password with other users, we recommend that you transition to use 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 can create one, and a location group if necessary, and then add your agency as a manager.

If a third party's client needs access to the API, the third party should not request access on their client's behalf. Instead, the client needs to apply for access themselves. A single project ID is used for the client's entire application. Once a client has invited you to an existing location group, you can access their account through your generated OAuth2.0 token.

Manage listing details

Changes you make with the Google My Business API might not be reflected immediately. Changes made to unverified locations only appear in the Google My Business interface. Either verified or unverified locations can be used to manage Google Ads location extensions.

Edits made to verified business locations are eligible to appear on other Google products. The edited listing might be subject to review to ensure that it adheres to the Google My Business quality guidelines and the Google+ content policy.

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 business details.

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 might differ on these dates. You can choose to set special hours to let customers know your hours of operation on these days.

The Google My Business API allows you to see your listing status 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 only use latitude and longitude when we can't locate your address. If they're included in subsequent update calls for existing locations, they won't be considered. Latitude and longitude details must be edited with the Google My Business user interface.

Attributes

Attributes are based on business category. For example, one attribute for a restaurant might be "serves breakfast." The attributes.list method can be used to get a list of attributes for a given category or country.

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

Support

Direct questions about the Google My Business API 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.