Google Business Profile

Integrate Mavera with Google Business Profile — multi-location review analysis, local persona creation, location content strategy, and response template generation

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

1. Google Cloud project

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

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

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

   Get your key from Mavera dashboard.
5. 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

---

All Integrations

Google Business API

Personas

Focus Groups

Generate

Mave Agent