Skip to content

Google Business Performance API

The Google Business Performance API fetches trailing-window results for one connected Google Business Profile. You get website clicks, call clicks, direction requests, messages, bookings, and impressions divided across Search and Maps and across desktop and mobile. It is built for location dashboards, not post-level reporting.

Google Business Performance API overview and location-level scope

Pick this endpoint when you need numbers for a single location. Results cover a trailing window and arrive as two layers: a shared metrics object and a Google-specific breakdown object. Because per-post Google Business analytics were deprecated in 2024, location-level data is what remains here. Get Analytics handles per-post metrics for other platforms and is a different endpoint. Make sure accountId points at the location you intend to report on, since everything returned belongs to that one Google Business Profile.

Request

Issue a GET request to the performance path, passing accountId and days as query parameters and sending the x-access-key header shown in the Endpoint request example. That example passes days=28, matching the default window. Keep the method, path, parameter names, and header name as shown, and configure only the origin through the base URL placeholder.

Query parameters input contract

accountId is a required string identifying the location integration. days is an optional integer setting the trailing window, accepted from 1 to 540 and defaulting to 28. daily is an optional boolean that decides whether daily carries a per-day series, defaulting to false. Before sending, confirm accountId is present, days is inside 1 to 540 when supplied, and daily is a boolean value.

Response field map and worked examples

Top-level fields are success, days, metrics, breakdown, and daily. Inside metrics, impressions totals Search and Maps, clicks counts website clicks, and reach, likes, comments, shares, saves, views, and engagementRate appear as null in this example because they do not apply to this location-level data. Breakdown holds the Google-specific figures: websiteClicks, callClicks, directionRequests, conversations for messages, bookings, plus an impressions object with desktopSearch, mobileSearch, desktopMaps, mobileMaps, and total. In the 28-day example, impressions total 745, websiteClicks is 10, callClicks is 2, directionRequests is 37, conversations is 0, and bookings is 0. By default daily is null. Setting daily=true turns it into an array whose entries carry date, websiteClicks, callClicks, directionRequests, conversations, bookings, and flattened fields impressionsDesktopSearch, impressionsMobileSearch, impressionsDesktopMaps, and impressionsMobileMaps. Branch on the type of daily before charting, since array code breaks on null and null checks break on an array.

Interpretation notes

Treat null entries in metrics as not applicable, not as zero, and take the actionable Google Business Profile figures from breakdown. Label conversations as messages and metrics.clicks as website clicks in any report you build, so readers do not misread them. This request costs 1 credit. For the terms people searched to find the profile, use Google Business Search Keywords; for a current follower or subscriber count, use Follower Count rather than deriving one from performance data.

Query parameters
ParameterTypeRequiredDescription
accountIdstringYesIntegration ID of the location from list_integrations
daysintegerNoTrailing window in days (1–540, default 28)
dailybooleanNoInclude a per-day time series in daily (default false)

Exact captured input contract

Response field map
FieldMeaning
metrics.impressionsTotal impressions across Search and Maps (745 in the example)
metrics.clicksWebsite clicks (10 in the example)
metrics.reach, likes, comments, shares, saves, views, engagementRateNull in this example; not applicable to this location-level data
breakdown.websiteClicksWebsite clicks (10)
breakdown.callClicksCall clicks (2)
breakdown.directionRequestsDirection requests (37)
breakdown.conversationsMessages (0)
breakdown.bookingsBookings (0)
breakdown.impressions.desktopSearchDesktop Search impressions (92)
breakdown.impressions.mobileSearchMobile Search impressions (553)
breakdown.impressions.desktopMapsDesktop Maps impressions (39)
breakdown.impressions.mobileMapsMobile Maps impressions (61)
breakdown.impressions.totalTotal impressions (745)
dailyNull by default; per-day array when daily=true

Exact captured response shape; example values from the 28-day response

Failure and interpretation matrix
SituationHow to interpret it
Missing accountIdRequest is incomplete; accountId is required and identifies the location integration
days outside 1–540Outside the captured valid range for the trailing window
daily omitted or falsedaily is null in the response
daily=truedaily is a per-day array with date and flattened impression fields
Null unified metrics fieldsNot applicable to this endpoint; use breakdown for Google-specific metrics
Expecting per-post statsNot available from this endpoint; only location-level performance remains

No error or status codes were supplied in this reference; do not invent them

Frequently asked questions

Where do I find website clicks, call clicks, and direction requests?

Read them from breakdown, which holds websiteClicks, callClicks, directionRequests, conversations for messages, bookings, and the four impression splits. In metrics, impressions is the Search plus Maps total and clicks means website clicks.

What changes when daily=true?

With daily omitted or false, daily is null. With daily=true, daily is an array of daily objects containing date, websiteClicks, callClicks, directionRequests, conversations, bookings, and flattened impression fields.

Does this endpoint return per-post performance?

No. This endpoint is scoped to one location. Per-post Google Business analytics were deprecated in 2024, so this endpoint does not return per-post stats. Get Analytics is the separate endpoint for per-post metrics on other platforms.

What is the cost of this request?

this request costs 1 credit.

Request example
GET {{API_BASE_URL}}/v1/googlebusiness/performance?accountId=INTEGRATION_ID&days=28
x-access-key: YOUR_ACCESS_KEY
28-day response example
{
	"success": true,
	"days": 28,
	"metrics": {
		"impressions": 745,
		"reach": null,
		"likes": null,
		"comments": null,
		"shares": null,
		"saves": null,
		"clicks": 10,
		"views": null,
		"engagementRate": null
	},
	"breakdown": {
		"websiteClicks": 10,
		"callClicks": 2,
		"directionRequests": 37,
		"conversations": 0,
		"bookings": 0,
		"impressions": {
			"desktopSearch": 92,
			"mobileSearch": 553,
			"desktopMaps": 39,
			"mobileMaps": 61,
			"total": 745
		}
	},
	"daily": null
}
Daily time series example with daily=true
{
	"daily": [
		{
			"date": "2026-10-13",
			"websiteClicks": 0,
			"callClicks": 0,
			"directionRequests": 1,
			"conversations": 0,
			"bookings": 0,
			"impressionsDesktopSearch": 5,
			"impressionsMobileSearch": 21,
			"impressionsDesktopMaps": 5,
			"impressionsMobileMaps": 2
		}
	]
}
Endpoint request 1
GET /v1/googlebusiness/performance?accountId=INTEGRATION_ID&days=28
x-access-key: YOUR_ACCESS_KEY