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.
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountId | string | Yes | Integration ID of the location from list_integrations |
| days | integer | No | Trailing window in days (1–540, default 28) |
| daily | boolean | No | Include a per-day time series in daily (default false) |
Exact captured input contract
| Field | Meaning |
|---|---|
| metrics.impressions | Total impressions across Search and Maps (745 in the example) |
| metrics.clicks | Website clicks (10 in the example) |
| metrics.reach, likes, comments, shares, saves, views, engagementRate | Null in this example; not applicable to this location-level data |
| breakdown.websiteClicks | Website clicks (10) |
| breakdown.callClicks | Call clicks (2) |
| breakdown.directionRequests | Direction requests (37) |
| breakdown.conversations | Messages (0) |
| breakdown.bookings | Bookings (0) |
| breakdown.impressions.desktopSearch | Desktop Search impressions (92) |
| breakdown.impressions.mobileSearch | Mobile Search impressions (553) |
| breakdown.impressions.desktopMaps | Desktop Maps impressions (39) |
| breakdown.impressions.mobileMaps | Mobile Maps impressions (61) |
| breakdown.impressions.total | Total impressions (745) |
| daily | Null by default; per-day array when daily=true |
Exact captured response shape; example values from the 28-day response
| Situation | How to interpret it |
|---|---|
| Missing accountId | Request is incomplete; accountId is required and identifies the location integration |
| days outside 1–540 | Outside the captured valid range for the trailing window |
| daily omitted or false | daily is null in the response |
| daily=true | daily is a per-day array with date and flattened impression fields |
| Null unified metrics fields | Not applicable to this endpoint; use breakdown for Google-specific metrics |
| Expecting per-post stats | Not 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.
GET {{API_BASE_URL}}/v1/googlebusiness/performance?accountId=INTEGRATION_ID&days=28
x-access-key: YOUR_ACCESS_KEY{
"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": [
{
"date": "2026-10-13",
"websiteClicks": 0,
"callClicks": 0,
"directionRequests": 1,
"conversations": 0,
"bookings": 0,
"impressionsDesktopSearch": 5,
"impressionsMobileSearch": 21,
"impressionsDesktopMaps": 5,
"impressionsMobileMaps": 2
}
]
}GET /v1/googlebusiness/performance?accountId=INTEGRATION_ID&days=28
x-access-key: YOUR_ACCESS_KEY