Skip to content

Google Business Performance API: Get Google Business Profile Location Performance

The Google Business Performance API endpoint described here returns Google Business Profile location performance for a connected location over a trailing window. It reports website clicks, call clicks, direction requests, messages as conversations, bookings, and profile impressions split by Search and Maps and by desktop and mobile, with an optional per-day time series when daily is set to true.

Get Google Business Profile location performance — exact contract summary

Use GET {{API_BASE_URL}}/v1/googlebusiness/performance to retrieve location-level performance for a connected Google Business Profile over a trailing window. The response keeps a unified metrics shape with impressions total and clicks, and adds a Google Business-specific breakdown with every breakdown metric. Pass daily=true for a per-day time series in daily. Only location-level metrics are available because per-post Google Business analytics were deprecated in 2024 according to the source contract. The source states a cost of 1 credit for this call.

Authorization

Send the access key in the x-access-key header. The header name is accessKey in the source contract, the location is header, and the value format is shown as <token>. If authentication fails, expect a 401 response with the preserved error shape described in the status matrix. Do not substitute a different authorization header for this endpoint.

Query Parameters

The required query parameter is accountId, a string containing the integration ID of the connected Google Business Profile location. The optional days parameter is an integer for the trailing window in days, defaulting to 28, with a range of 1 <= value <= 540. The optional daily parameter is a boolean, defaulting to false, and includes a per-day time series in daily when set to true. Validate accountId presence, days range, and daily type before calling, because invalid values map to the 400 status in the contract.

Response Body

See the worked request example titled Request example: location performance with required accountId for the exact origin-modular request, and the 200 response example titled 200 response example: metrics, breakdown and daily for the full success body. The success body contains success, days, metrics, breakdown and daily. The metrics object uses the unified shape, while breakdown contains websiteClicks, callClicks, directionRequests, conversations, bookings and impressions with desktopSearch, mobileSearch, desktopMaps, mobileMaps and total. When daily=true, each daily entry contains date, websiteClicks, callClicks, directionRequests, conversations, bookings, impressionsDesktopSearch, impressionsMobileSearch, impressionsDesktopMaps and impressionsMobileMaps.

200 application/json

For a 200 application/json response, check success first, then read days to confirm the trailing window that was applied. Use metrics for the unified impressions and clicks view, and use breakdown for the Google Business-specific action counts and impressions split. Treat metrics values as number or null where the typed contract declares number | null, and treat avgWatchTime, totalWatchTime and skipRate as optional fields. The daily field is declared as array<object> | null in the typed contract, so handle both an array and null without assuming a new rule.

400 application/json

A 400 application/json response uses the preserved shape with success and message. The source does not supply specific message strings for this status, so client code should surface message as returned and check the request parameters, especially accountId, days and daily, before retrying.

401 application/json

A 401 application/json response uses the preserved shape with success and message. The source does not supply specific message strings for this status, so client code should verify the x-access-key header value and surface message as returned.

402 application/json

A 402 application/json response uses the preserved shape with success and message. The source does not supply specific message strings for this status, so client code should surface message as returned and not invent a credit or billing interpretation beyond the numeric status.

404 application/json

A 404 application/json response uses the preserved shape with success and message. The source does not supply specific message strings for this status, so client code should surface message as returned and verify that accountId identifies a connected Google Business Profile location.

502 application/json

A 502 application/json response uses the preserved shape with success and message. The source does not supply specific message strings or retry semantics for this status, so client code should surface message as returned and avoid assuming retry behavior that is not in the contract.

Choosing days and daily, and location-level scope

Choose days based on the comparison you need: the default 28 is suitable for a recent trailing window, while larger values up to 540 extend the window within the stated range. Choose daily=true when you need to see which days drove websiteClicks, callClicks, directionRequests, conversations, bookings or impressions, and leave daily=false for aggregate reporting. Always scope the call to one connected location via accountId, and interpret impressions through breakdown.impressions rather than through per-post data, which is not available from this endpoint.

Query parameters for GET /v1/googlebusiness/performance
ParameterRequiredTypeDefaultConstraints / notes
accountIdRequired (*)string—Integration ID of the connected Google Business Profile location.
daysOptional (?)integer28Trailing window in days; range 1 <= value <= 540.
dailyOptional (?)booleanfalseInclude a per-day time series in daily when true.

Exact source contract preserved; origin replaced only by {{API_BASE_URL}}.

200 response field map
FieldTypeRequiredNotes
successbooleanRequiredTop-level success flag.
daysintegerRequiredTrailing window applied.
metricsobjectRequiredUnified shape: impressions, reach, likes, comments, shares, saves, clicks, views, engagementRate as number | null; avgWatchTime, totalWatchTime, skipRate optional number | null.
breakdownobjectRequiredGoogle Business-specific breakdown described below.
dailyarray<object> | nullRequiredPer-day time series when daily=true; typed contract also allows null.

Typed contract preserved, including number | null metrics fields and optional watch-time fields.

Breakdown and daily field map
FieldTypeRequiredNotes
breakdown.websiteClicksintegerRequiredWebsite clicks in breakdown.
breakdown.callClicksintegerRequiredCall clicks in breakdown.
breakdown.directionRequestsintegerRequiredDirection requests in breakdown.
breakdown.conversationsintegerRequiredMessages (conversations) in breakdown.
breakdown.bookingsintegerRequiredBookings in breakdown.
breakdown.impressions.desktopSearchintegerRequiredDesktop Search impressions.
breakdown.impressions.mobileSearchintegerRequiredMobile Search impressions.
breakdown.impressions.desktopMapsintegerRequiredDesktop Maps impressions.
breakdown.impressions.mobileMapsintegerRequiredMobile Maps impressions.
breakdown.impressions.totalintegerRequiredTotal impressions in breakdown.
daily[].datestringRequiredDate for the daily entry.
daily[].websiteClicks / callClicks / directionRequests / conversations / bookingsintegerRequiredPer-day action counts.
daily[].impressionsDesktopSearch / impressionsMobileSearch / impressionsDesktopMaps / impressionsMobileMapsintegerRequiredPer-day impressions split fields.

Exact field names preserved from source contract.

Status matrix
StatusContent typeResponse shapeNotes
200application/jsonsuccess, days, metrics, breakdown, dailySuccess body as in the 200 response example.
400application/jsonsuccess, messageError shape preserved; no invented message text.
401application/jsonsuccess, messageError shape preserved; no invented message text.
402application/jsonsuccess, messageError shape preserved; no invented message text.
404application/jsonsuccess, messageError shape preserved; no invented message text.
502application/jsonsuccess, messageError shape preserved; no invented message text.

Only numeric status and {success, message} shape preserved; message strings not supplied in source.

Frequently asked questions

How do I choose days and daily for Google Business Profile location performance?

Use the required accountId for the connected Google Business Profile location, choose days for the trailing window (default 28, range 1 to 540), and set daily=true only when you need the per-day time series in the daily field. Check breakdown for websiteClicks, callClicks, directionRequests, conversations, bookings and impressions split by desktopSearch, mobileSearch, desktopMaps and mobileMaps.

What is the difference between metrics and breakdown in the response?

The metrics object keeps the unified shape, including impressions and clicks, while breakdown carries the Google Business-specific counts. Treat nullable metrics fields as number or null, and note that avgWatchTime, totalWatchTime and skipRate are optional in the typed contract.

Can this endpoint return per-post Google Business performance?

Only location-level metrics are available. Per-post Google Business analytics were deprecated in 2024 according to the source contract, so do not expect per-post performance fields from this endpoint.

Request example: location performance with required accountId
curl -X GET "{{API_BASE_URL}}/v1/googlebusiness/performance?accountId=string" -H "x-access-key: <token>"
200 response example: metrics, breakdown and daily
{
  "success": true,
  "days": 0,
  "metrics": {
    "impressions": 0,
    "reach": 0,
    "likes": 0,
    "comments": 0,
    "shares": 0,
    "saves": 0,
    "clicks": 0,
    "views": 0,
    "engagementRate": 0,
    "avgWatchTime": 0,
    "totalWatchTime": 0,
    "skipRate": 0
  },
  "breakdown": {
    "websiteClicks": 0,
    "callClicks": 0,
    "directionRequests": 0,
    "conversations": 0,
    "bookings": 0,
    "impressions": {
      "desktopSearch": 0,
      "mobileSearch": 0,
      "desktopMaps": 0,
      "mobileMaps": 0,
      "total": 0
    }
  },
  "daily": [
    {
      "date": "string",
      "websiteClicks": 0,
      "callClicks": 0,
      "directionRequests": 0,
      "conversations": 0,
      "bookings": 0,
      "impressionsDesktopSearch": 0,
      "impressionsMobileSearch": 0,
      "impressionsDesktopMaps": 0,
      "impressionsMobileMaps": 0
    }
  ]
}
Error response shape for 400, 401, 402, 404 and 502
{
  "success": true,
  "message": "string"
}
Interface fields
ScopeFieldTypeType referenceRequiredDescription
response#1responseobject__0
response#1response.successboolean__1Yes
response#1response.daysinteger__2Yes
response#1response.metricsobject__3Yes
response#1response.metrics.impressionsnumber | null__4Yes
response#1response.metrics.impressions[variant1]number__4_type:number
response#1response.metrics.impressions[variant2]null__4_type:null
response#1response.metrics.reachnumber | null__5Yes
response#1response.metrics.reach[variant1]number__5_type:number
response#1response.metrics.reach[variant2]null__5_type:null
response#1response.metrics.likesnumber | null__6Yes
response#1response.metrics.likes[variant1]number__6_type:number
response#1response.metrics.likes[variant2]null__6_type:null
response#1response.metrics.commentsnumber | null__7Yes
response#1response.metrics.comments[variant1]number__7_type:number
response#1response.metrics.comments[variant2]null__7_type:null
response#1response.metrics.sharesnumber | null__8Yes
response#1response.metrics.shares[variant1]number__8_type:number
response#1response.metrics.shares[variant2]null__8_type:null
response#1response.metrics.savesnumber | null__9Yes
response#1response.metrics.saves[variant1]number__9_type:number
response#1response.metrics.saves[variant2]null__9_type:null
response#1response.metrics.clicksnumber | null__10Yes
response#1response.metrics.clicks[variant1]number__10_type:number
response#1response.metrics.clicks[variant2]null__10_type:null
response#1response.metrics.viewsnumber | null__11Yes
response#1response.metrics.views[variant1]number__11_type:number
response#1response.metrics.views[variant2]null__11_type:null
response#1response.metrics.engagementRatenumber | null__12YesEngagement rate (0-1). null when the platform does not report engagement.
response#1response.metrics.engagementRate[variant1]number__12_type:numberEngagement rate (0-1). null when the platform does not report engagement.
response#1response.metrics.engagementRate[variant2]null__12_type:nullEngagement rate (0-1). null when the platform does not report engagement.
response#1response.metrics.avgWatchTimenumber | null__13NoInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#1response.metrics.avgWatchTime[variant1]number__13_type:numberInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#1response.metrics.avgWatchTime[variant2]null__13_type:nullInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#1response.metrics.totalWatchTimenumber | null__14NoInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#1response.metrics.totalWatchTime[variant1]number__14_type:numberInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#1response.metrics.totalWatchTime[variant2]null__14_type:nullInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#1response.metrics.skipRatenumber | null__15NoInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#1response.metrics.skipRate[variant1]number__15_type:numberInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#1response.metrics.skipRate[variant2]null__15_type:nullInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#1response.breakdownobject__16Yes
response#1response.breakdown.websiteClicksinteger__17Yes
response#1response.breakdown.callClicksinteger__18Yes
response#1response.breakdown.directionRequestsinteger__19Yes
response#1response.breakdown.conversationsinteger__20Yes
response#1response.breakdown.bookingsinteger__21Yes
response#1response.breakdown.impressionsobject__22Yes
response#1response.breakdown.impressions.desktopSearchinteger__23Yes
response#1response.breakdown.impressions.mobileSearchinteger__24Yes
response#1response.breakdown.impressions.desktopMapsinteger__25Yes
response#1response.breakdown.impressions.mobileMapsinteger__26Yes
response#1response.breakdown.impressions.totalinteger__27Yes
response#1response.dailyarray<object> | null__28Yes
response#1response.daily[variant1]array<object>__28_extends:__29
response#1response.daily[variant1][]object__30
response#1response.daily[variant1][].datestring__31Yes
response#1response.daily[variant1][].websiteClicksinteger__32Yes
response#1response.daily[variant1][].callClicksinteger__33Yes
response#1response.daily[variant1][].directionRequestsinteger__34Yes
response#1response.daily[variant1][].conversationsinteger__35Yes
response#1response.daily[variant1][].bookingsinteger__36Yes
response#1response.daily[variant1][].impressionsDesktopSearchinteger__37Yes
response#1response.daily[variant1][].impressionsMobileSearchinteger__38Yes
response#1response.daily[variant1][].impressionsDesktopMapsinteger__39Yes
response#1response.daily[variant1][].impressionsMobileMapsinteger__40Yes
response#1response.daily[variant2]null__28_extends:__41
response#2responseobject__0
response#2response.successboolean__1Yes
response#2response.messagestring__2Yes