The Business Profile Performance API is now launched! Migration work is required.
Review the deprecation schedule and instructions to migrate over to new v1 APIs from older deprecated v4 API.
Help us improve the food menu experience by filling in this survey to better understand what place, menu, and dish attributes you can provide about the merchants you support

Method: categories.batchGet

Returns a list of business categories for the provided language and GConcept ids.

HTTP request


The URL uses gRPC Transcoding syntax.

Query parameters



Required. The BCP 47 code of language that the category names should be returned in.



Required. At least one name must be set. The GConcept ids the localized category names should be returned for.



Optional. The ISO 3166-1 alpha-2 country code used to infer non-standard language.


enum (CategoryView)

Required. Specifies which parts to the Category resource should be returned in the response.

Request body

The request body must be empty.

Response body

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

Response message for BusinessCategories.BatchGetBusinessCategories.

JSON representation
  "categories": [
      object (Category)

object (Category)

Categories that match the GConcept ids provided in the request. They will not come in the same order as category ids in the request.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the OAuth 2.0 Overview.