Skip to content

Google My Business API API

by googleapis.com

No authHTTPSAnalytics
Open documentation ↗

Overview

The Google My Business API provides an interface for managing business location information on Google.

Google My Business API is an analytics API from googleapis.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 50 endpoints.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://mybusiness.googleapis.com/
Version
v4
Endpoints
50
Spec updated
2021-11-04

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://mybusiness.googleapis.com/v4/accounts" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://mybusiness.googleapis.com/v4/accounts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://mybusiness.googleapis.com/v4/accounts",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/v4/accountsLists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management r
POST/v4/accountsCreates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be cre
GET/v4/attributesReturns the list of available attributes that would be available for a location with the given primary category and country.
GET/v4/categoriesReturns a list of business categories. Search will match the category name but not the category ID. *Note:* Search only matches the front of a category name (th
GET/v4/categories:batchGetReturns a list of business categories for the provided language and GConcept ids.
GET/v4/chains:searchSearches the chain based on chain name.
POST/v4/googleLocations:searchSearch all of the possible locations that are a match to the specified request.
GET/v4/{name}Gets the specified chain. Returns `NOT_FOUND` if the chain does not exist.
PUT/v4/{name}Sets the pubsub notification settings for the account informing Business Profile which topic to send pubsub notifications for: - New reviews for locations admin
PATCH/v4/{name}Updates a specific question written by the current user.
DELETE/v4/{name}Deletes a specific question written by the current user.
POST/v4/{name}/localPosts:reportInsightsReturns insights for a set of local posts associated with a single listing. Which metrics and how they are reported are options specified in the request proto.
POST/v4/{name}/locations:batchGetGets all of the specified locations in the given account.
POST/v4/{name}/locations:batchGetReviewsReturns the paginated list of reviews for all specified locations. This operation is only valid if the specified locations are verified. *Note:* Reviews are lim
POST/v4/{name}/locations:reportInsightsReturns a report containing insights on one or more metrics by location. *Note:* Insight reports are limited to a batch size of 10 `location_names` per call.
PUT/v4/{name}/replyUpdates the reply to the specified review. A reply is created if one does not exist. This operation is only valid if the specified location is verified.
DELETE/v4/{name}/replyDeletes the response to the specified review. This operation is only valid if the specified location is verified.
POST/v4/{name}:acceptAccepts the specified invitation.
POST/v4/{name}:associateAssociates a location to a place ID. Any previous association is overwritten. This operation is only valid if the location is unverified. The association must b
POST/v4/{name}:clearAssociationClears an association between a location and its place ID. This operation is only valid if the location is unverified.
POST/v4/{name}:completeCompletes a `PENDING` verification. It is only necessary for non `AUTO` verification methods. `AUTO` verification request is instantly `VERIFIED` upon creation.
POST/v4/{name}:declineDeclines the specified invitation.
POST/v4/{name}:fetchVerificationOptionsReports all eligible verification options for a location in a specific language.
POST/v4/{name}:findMatchesFinds all of the possible locations that are a match to the specified location. This operation is only valid if the location is unverified.
POST/v4/{name}:generateAccountNumberGenerates an account number for this account. The account number is not provisioned when an account is created. Use this request to create an account number whe
GET/v4/{name}:getGoogleUpdatedReturns the Google updated Lodging of a specific location.
GET/v4/{name}:googleUpdatedGets the Google-updated version of the specified location. Returns `NOT_FOUND` if the location does not exist.
GET/v4/{name}:recommendGoogleLocationsList all the GoogleLocations that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and locati
POST/v4/{name}:reportReport a GoogleLocation.
POST/v4/{name}:transferMoves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is
POST/v4/{name}:verifyStarts the verification process for a location.
GET/v4/{parent}/adminsLists all of the admins for the specified location.
POST/v4/{parent}/adminsInvites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the lo
GET/v4/{parent}/answersReturns the paginated list of answers for a specified question.
DELETE/v4/{parent}/answers:deleteDeletes the answer written by the current user to a question.
POST/v4/{parent}/answers:upsertCreates an answer or updates the existing answer written by the user for the specified question. A user can only create one answer per question.
GET/v4/{parent}/insuranceNetworksReturns a list of all insurance networks supported by Google.
GET/v4/{parent}/invitationsLists pending invitations for the specified account.
GET/v4/{parent}/localPostsReturns a list of local posts associated with a location.
POST/v4/{parent}/localPostsCreates a new local post associated with the specified location, and returns it.
GET/v4/{parent}/locationsLists the locations for the specified account.
POST/v4/{parent}/locationsCreates a new location owned by the specified account, and returns it.
GET/v4/{parent}/mediaReturns a list of media items associated with a location.
POST/v4/{parent}/mediaCreates a new media item for the location.
GET/v4/{parent}/media/customersReturns a list of media items associated with a location that have been contributed by customers.
POST/v4/{parent}/media:startUploadGenerates a `MediaItemDataRef` for media item uploading.
GET/v4/{parent}/questionsReturns the paginated list of questions and some of its answers for a specified location.
POST/v4/{parent}/questionsAdds a question for the specified location.
GET/v4/{parent}/reviewsReturns the paginated list of reviews for the specified location. This operation is only valid if the specified location is verified.
GET/v4/{parent}/verificationsList verifications of a location, ordered by create time.

Questions

Does the Google My Business API API need an API key?

No. The Google My Business API API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the Google My Business API API support HTTPS?

Yes, the Google My Business API API is served over HTTPS.

How many endpoints does the Google My Business API API have?

Its OpenAPI description lists 50 endpoints in version v4. All of them are shown on this page.

What are alternatives to the Google My Business API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).