Google Business Profile

Overview

Pull data from Google Business Profile (Reviews, Locations, Insights) → analyze with Mavera (Mave Agent, Personas, Focus Groups, Generate) → get location-specific brand intelligence, geo-targeted personas, and templated review responses for multi-location businesses.

Google Business Profile API — Base URL: https://mybusiness.googleapis.com/v4/. Auth: OAuth 2.0 (service account or user consent). Rate limits: 300 queries/min. Requires a verified Google Business Profile.

Google is migrating the My Business API to the Google Business Profile API (https://mybusinessbusinessinformation.googleapis.com/v1/). The review endpoints are now under Account Management API. Code examples use both legacy and new endpoints — check migration guide for your account status.

Prerequisites

Google Cloud project

Create a project in Google Cloud Console with the My Business API enabled.

OAuth credentials

Set up OAuth 2.0 credentials (Desktop or Service Account). For service accounts, enable domain-wide delegation.

Business Profile access

The OAuth user must be an owner or manager of the Google Business Profile locations.

Mavera API key

Get your key from Mavera dashboard.

Environment variables

export GOOGLE_ACCESS_TOKEN="ya29.xxxxx"
export GOOGLE_ACCOUNT_ID="accounts/123456789"
export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#	Job	Google Data	Mavera Surface	Output
1	Multi-Location Review Analysis	batchGetReviews	Mave Agent	Cross-location feedback comparison
2	Local Persona Creation	Reviews with location	Custom Personas	Geo-specific customer personas
3	Review Themes → Local Content Strategy	Themes per location	Generate	Location-specific marketing content
4	Response Template Generation	Common review themes	Generate	Per-theme response templates

Rate Limits & Production Notes

Google Endpoint	Limit	Strategy
All GBP endpoints	300 queries/min	Generous; use 300ms delays per location
Reviews per location	Paginate with `pageToken`	Max 50 per page
Location list	Single call per account	Cache location IDs daily
Reply to review	Per-review write	Queue and rate-limit to 1/sec

Google is migrating the My Business API to new individual APIs (Business Information, Business Performance, etc.). Review endpoints may change. Monitor the deprecation timeline and update base URLs accordingly.

Checklist:

OAuth 2.0 required (no API key option for business data)
Star ratings are strings (ONE-FIVE), not integers
Paginate reviews with nextPageToken
Cache location IDs and metadata (rarely changes)
Service accounts need domain-wide delegation for Business Profile access
Monitor Mavera credits at Dashboard

​Overview

​Prerequisites

​Jobs

​Rate Limits & Production Notes

All Integrations

Google Business API

Personas

Focus Groups

Generate

Mave Agent

Overview

Prerequisites

Jobs

Rate Limits & Production Notes