For Agents
Pull daily and monthly performance metrics — calls, views, direction requests, and search-keyword impressions — for verified Google Business Profile locations.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Business Profile Performance API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Business Profile Performance API.
Fetch a single daily metric time series for a Business Profile location over a chosen date range
Fetch multiple daily metric time series for one location in a single call to reduce round trips
Retrieve monthly search-keyword impression counts that drove customers to a location
GET STARTED
Use for: Get daily call counts for a Business Profile location, Retrieve direction-request metrics for the last 30 days, Find which search keywords drove impressions to my Business Profile, List monthly impression counts by keyword for a location
Not supported: Does not handle profile edits, review responses, or post publishing — use for reading location performance metrics only.
The Google Business Profile Performance API exposes daily and monthly performance metrics for verified Business Profile locations, covering search impressions, map views, calls, direction requests, website clicks, and search-keyword impressions. It is designed for multi-location operators, agencies, and analytics platforms that need to ingest Business Profile insights at scale rather than read them from the Business Profile Manager UI. The current v1 surface is small and tightly scoped — three reporting endpoints — but covers the metrics most retailers and service businesses care about.
Filter metrics by SubEntityType to separate business profile views from map and search interactions
Aggregate location-level performance data into multi-location dashboards
Patterns agents use Business Profile Performance API for, with concrete tasks.
★ Multi-Location Performance Dashboards
Agencies and franchise operators ingest daily call, direction, and impression metrics for every location they manage and render them in a single dashboard. Using fetchMultiDailyMetricsTimeSeries returns several metrics in one round trip, which keeps API quota usage low even across hundreds of locations. Most teams refresh nightly into a warehouse and visualise in Looker or BigQuery.
Call /v1/locations/12345:fetchMultiDailyMetricsTimeSeries with dailyMetrics=CALL_CLICKS,WEBSITE_CLICKS,BUSINESS_DIRECTION_REQUESTS for the last 28 days and return totals per metric.
Search Keyword Insights for Local SEO
Local SEO specialists use the searchkeywords/impressions/monthly endpoint to see which queries are surfacing each location in Google Search and Maps, then prioritise content and category tuning around the top queries. The endpoint returns up to the trailing 6 months of monthly keyword impressions per location, suitable for trend analysis.
Retrieve the last 3 months of search-keyword impressions for location 12345 and return the top 10 keywords by impression count.
Operations Alerts for Drop-offs
Operations teams monitor day-over-day calls and direction-request metrics to detect anomalies such as a sudden drop after a profile edit, a category change, or a Google policy action. Alerts are triggered when daily metrics deviate beyond a threshold versus the trailing 14-day baseline. The API's daily granularity makes this practical without scraping the Business Profile Manager UI.
Compare yesterday's CALL_CLICKS for location 12345 to the trailing 14-day average and flag if it dropped more than 50%.
AI Agent Local Marketing Reporter via Jentic
An AI agent through Jentic pulls Business Profile Performance metrics on demand for a marketing manager, summarising the week's keyword impressions, calls, and direction requests across a portfolio of locations. Jentic isolates the OAuth token and exposes the three endpoints as named tools that the agent can call without parsing the discovery document.
Through Jentic, search the businessprofileperformance_get_daily_metrics operation, load its schema, and execute it for location 12345 with dailyMetric=CALL_CLICKS over a 7-day window.
3 endpoints — the google business profile performance api exposes daily and monthly performance metrics for verified business profile locations, covering search impressions, map views, calls, direction requests, website clicks, and search-keyword impressions.
METHOD
PATH
DESCRIPTION
/v1/{+name}:getDailyMetricsTimeSeries
Fetch a single daily metric time series for a location
/v1/{+location}:fetchMultiDailyMetricsTimeSeries
Fetch multiple daily metrics for a location in one call
/v1/{+parent}/searchkeywords/impressions/monthly
Retrieve monthly search-keyword impressions for a location
/v1/{+name}:getDailyMetricsTimeSeries
Fetch a single daily metric time series for a location
/v1/{+location}:fetchMultiDailyMetricsTimeSeries
Fetch multiple daily metrics for a location in one call
/v1/{+parent}/searchkeywords/impressions/monthly
Retrieve monthly search-keyword impressions for a location
Three things that make agents converge on Jentic-routed access.
Credential isolation
Google OAuth refresh tokens scoped to business.manage are stored encrypted in the Jentic vault (MAXsystem). Agents receive short-lived access tokens — refresh tokens and client secrets never enter the agent context.
Intent-based discovery
Agents search Jentic by intent (e.g. 'get daily call metrics for a Google Business Profile') and Jentic returns the fetchMultiDailyMetricsTimeSeries operation with its parameter schema.
Time to first call
Direct integration: 1-2 days for OAuth setup, consent screen verification, and metric enum handling. Through Jentic: under 1 hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Business Profile Performance API through Jentic.
What authentication does the Business Profile Performance API use?
It requires OAuth 2.0 with the business.manage scope on a Google account that owns or manages the target Business Profile location. Through Jentic, the OAuth refresh token is stored encrypted in the Jentic vault and the agent only ever holds short-lived access tokens scoped to the call.
What metrics can I retrieve with the Business Profile Performance API?
Daily metrics include BUSINESS_IMPRESSIONS_DESKTOP_MAPS, BUSINESS_IMPRESSIONS_DESKTOP_SEARCH, BUSINESS_IMPRESSIONS_MOBILE_MAPS, BUSINESS_IMPRESSIONS_MOBILE_SEARCH, CALL_CLICKS, WEBSITE_CLICKS, and BUSINESS_DIRECTION_REQUESTS. Monthly search-keyword impression counts are available via /v1/{parent}/searchkeywords/impressions/monthly.
What are the rate limits for the Business Profile Performance API?
Google enforces a per-project quota that defaults to several hundred requests per minute. Fetching multiple metrics in a single fetchMultiDailyMetricsTimeSeries call is the standard pattern for staying inside quota when reporting across many locations.
How do I get keyword impressions through Jentic?
Use the Jentic search query "google business profile keyword impressions" to discover the searchkeywords.impressions.monthly operation, load its schema, and execute it with the parent location resource and the desired monthlyRange. Run pip install jentic to get started.
How far back does the Business Profile Performance API go?
Daily metrics are available for roughly the trailing 18 months and monthly search-keyword impressions for the trailing 6 months. Older data is not available through this API and must be archived by the caller if longer history is needed.
Is the Business Profile Performance API free?
Yes, there is no per-call charge from Google. Standard Google Cloud project quota applies and higher limits can be requested through the Cloud console.