Google Business Performance API has a
NEW API method that allows fetching multiple `DailyMetrics` in a single API request. Review the
deprecation schedule and instructions to migrate over from v4 reportInsights API method to Google Business Profile Performance API.
Business Information API
Stay organized with collections
Save and categorize content based on your preferences.
Change log
v1
API Access
The Business Information API will need to be enabled from the GCP Console. The OAuth scope remains the same.
Endpoint URL
Endpoints for all business information, attributes, categories, chains and locations search are accessible at https://mybusinessbusinessinformation.googleapis.com/v1/ instead of https://mybusiness.googleapis.com/v4/
The path name for locations endpoints has changed from accounts/accountId/locations/locationId to locations/locationId
Location Updates
locationName has been renamed to title.websiteUrl has been renamed to websiteUri.accounts.locations.list and locations.get now requires a readMask.primaryPhone and additionalPhones are now part of
PhoneNumbers.primaryCategory and additionalCategories are now part of
Categories.address has been renamed to storefrontAddress.accounts.locations.clearAssociation has been updated to
locations.clearLocationAssociation.serviceItems are now read and updated directly from the Location object.
Attributes
- New
Attributes object and corresponding locations.attributes.getGoogleUpdated endpoint to get the Google updated version.
attributes.list has a show_all parameter allowing clients to see all the various attributes that can be set for a particular category and region combination.
Service Area Businesses
- Businesses of type
CUSTOMER_LOCATION_ONLY are no longer required to fill
out an address.
- Addition of
regionCode in
ServiceAreaBusiness.
It must be set for businesses of type CUSTOMER_LOCATION_ONLY.
Deprecated Endpoints and Objects
- Removal of
LocationKey object. The existing fields have been moved into
Metadata.
- Removal of
PriceLists object. It has been replaced by FoodMenus and
ServiceLists.
- Removal of
LocationState object. Most of the existing fields have been moved into
Metadata. Although Metadata contains a boolean to see whether the merchant has full control of the business (voice of merchant), more detailed suspension and verification related fields have been moved to the Verifications API. Use method locations.getVoiceOfMerchantState for next steps in order to gain voice of merchant.
- The endpoints
googleLocations.report and
accounts.locations.findMatchingLocations have been deprecated.
TransferLocation endpoint has been moved to locations.transfer under the
Account Management API.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe Business Information API now uses \u003ccode\u003ehttps://mybusinessbusinessinformation.googleapis.com/v1/\u003c/code\u003e as the base endpoint and requires enabling in the GCP Console.\u003c/p\u003e\n"],["\u003cp\u003eLocation data structure has been updated, renaming or relocating fields like \u003ccode\u003elocationName\u003c/code\u003e, \u003ccode\u003ewebsiteUrl\u003c/code\u003e, \u003ccode\u003eprimaryPhone\u003c/code\u003e, \u003ccode\u003eprimaryCategory\u003c/code\u003e, and \u003ccode\u003eaddress\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA new \u003ccode\u003eAttributes\u003c/code\u003e object and \u003ccode\u003egetGoogleUpdated\u003c/code\u003e endpoint have been introduced for managing business attributes, and \u003ccode\u003eattributes.list\u003c/code\u003e now includes a \u003ccode\u003eshow_all\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eService area businesses (\u003ccode\u003eCUSTOMER_LOCATION_ONLY\u003c/code\u003e) no longer require an address but need a \u003ccode\u003eregionCode\u003c/code\u003e, while \u003ccode\u003eLocationKey\u003c/code\u003e, \u003ccode\u003ePriceLists\u003c/code\u003e, and \u003ccode\u003eLocationState\u003c/code\u003e objects are deprecated.\u003c/p\u003e\n"],["\u003cp\u003eSome endpoints have been moved or deprecated, including \u003ccode\u003egoogleLocations.report\u003c/code\u003e, \u003ccode\u003eaccounts.locations.findMatchingLocations\u003c/code\u003e, and \u003ccode\u003eTransferLocation\u003c/code\u003e.\u003c/p\u003e\n"]]],["The Business Information API requires enabling in the GCP Console, with a new endpoint URL: `https://mybusinessbusinessinformation.googleapis.com/v1/`. Location endpoints' path changed to `locations/locationId`. Updates include renaming fields like `locationName` to `title` and incorporating `PhoneNumbers` and `Categories`. `Attributes` now includes a `getGoogleUpdated` endpoint, with `show_all` parameter. Service area businesses (type `CUSTOMER_LOCATION_ONLY`) now require `regionCode`. Deprecated objects include `LocationKey`, `PriceLists`, `LocationState`, and removed endpoints `googleLocations.report`, `accounts.locations.findMatchingLocations`, and `TransferLocation` moved.\n"],null,["# Business Information API\n\n\u003cbr /\u003e\n\nChange log\n----------\n\n### v1\n\n#### API Access\n\nThe Business Information API will need to be enabled from the [GCP Console](https://console.developers.google.com/apis/library/mybusinessbusinessinformation.googleapis.com). The OAuth scope remains the same.\n\n#### Endpoint URL\n\nEndpoints for all business information, attributes, categories, chains and locations search are accessible at `https://mybusinessbusinessinformation.googleapis.com/v1/` instead of `https://mybusiness.googleapis.com/v4/`\n\nThe path name for locations endpoints has changed from `accounts/accountId/locations/locationId` to `locations/locationId`\n\n#### Location Updates\n\n- `locationName` has been renamed to `title`.\n- `websiteUrl` has been renamed to `websiteUri`.\n- `accounts.locations.list` and `locations.get` now requires a readMask.\n- `primaryPhone` and `additionalPhones` are now part of [PhoneNumbers](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PhoneNumbers).\n- `primaryCategory` and `additionalCategories` are now part of [Categories](/my-business/reference/businessinformation/rest/v1/accounts.locations#categories).\n- `address` has been renamed to `storefrontAddress`.\n- `accounts.locations.clearAssociation` has been updated to `locations.clearLocationAssociation`.\n- `serviceItems` are now read and updated directly from the Location object.\n\n#### Attributes\n\n- New `Attributes` object and corresponding [locations.attributes.getGoogleUpdated](/my-business/reference/businessinformation/rest/v1/locations.attributes/getGoogleUpdated) endpoint to get the Google updated version.\n- `attributes.list` has a `show_all` parameter allowing clients to see all the various attributes that can be set for a particular category and region combination.\n\n#### Service Area Businesses\n\n- Businesses of type `CUSTOMER_LOCATION_ONLY` are no longer required to fill out an address.\n- Addition of `regionCode` in [ServiceAreaBusiness](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.ServiceAreaBusiness). It must be set for businesses of type `CUSTOMER_LOCATION_ONLY`.\n\n#### Deprecated Endpoints and Objects\n\n- Removal of `LocationKey` object. The existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata).\n- Removal of `PriceLists` object. It has been replaced by FoodMenus and ServiceLists.\n- Removal of `LocationState` object. Most of the existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata). Although Metadata contains a boolean to see whether the merchant has full control of the business (voice of merchant), more detailed suspension and verification related fields have been moved to the [Verifications API](/my-business/reference/verifications/rest). Use method [locations.getVoiceOfMerchantState](/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) for next steps in order to gain voice of merchant.\n- The endpoints `googleLocations.report` and `accounts.locations.findMatchingLocations` have been deprecated.\n- `TransferLocation` endpoint has been moved to `locations.transfer` under the Account Management API."]]