Update your Google Business Profile API integration before critical endpoints are disabled. Review the deprecation schedule and instructions to avoid disruptions starting in April 2022.
The Business Profile Performance API is now launched! Migration work is required.

Method: googleLocations.search

Search all of the possible locations that are a match to the specified request.

HTTP request

POST https://mybusinessbusinessinformation.googleapis.com/v1/googleLocations:search

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "pageSize": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  "query": string
  // End of list of possible types for union field search_query.


The number of matches to return. The default value is 3, with a maximum of 10. Note that latency may increase if more are requested. There is no pagination.

Union field search_query. Search query. This can be provided either as a location object or as a string query. search_query can be only one of the following:

object (Location)

Location to search for. If provided, will find locations which match the provided location details.



Text query to search for. The search results from a query string will be less accurate than if providing an exact location, but can provide more inexact matches.

Response body

If successful, the response body contains data with the following structure:

Response message for GoogleLocations.SearchGoogleLocations.

JSON representation
  "googleLocations": [
      object (GoogleLocation)

object (GoogleLocation)

A collection of GoogleLocations that are potential matches to the specified request, listed in order from most to least accuracy.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/business.manage

For more information, see the OAuth 2.0 Overview.