Skip to main content

Google Business Performance

Daily performance of a connected Google Business Profile location for the date range you choose, and the search keywords people used to find it. Both endpoints read Google's Business Profile Performance API. The Google Business connection already includes the required permission (business.manage), so no reconnection is needed.

  • Authentication: API Key — Authorization: Apikey <YOUR_API_KEY>
Which location?

location_id (locations/123, a bare 123 or accounts/456/locations/123) → the location pinned to the profile → the account's only location. The location must belong to the Google Business account connected to the profile; any other location gets 404 location_not_found. List them with Get Google Business Locations.

Data arrives late

Google publishes these numbers with a delay of several days, so the most recent days are often 0. Upload-Post keeps what Google returned for a few hours (closed months for longer), so asking again for the same range right away returns the same numbers.

The 30-day summary in Get Analytics (platforms=google_business) uses the same data.

Daily metrics​

  • Method: GET
  • Endpoint: /api/uploadposts/google-business/performance

Query Parameters​

ParameterTypeRequiredDescription
userstringYesThe profile username that owns the connected Google Business account.
location_idstringNoSee "Which location?" above.
metricsstringNoComma-separated metrics (see the table below). Default: all of them. Also accepted as metric.
start_datestringNoYYYY-MM-DD. Default: 29 days before end_date. At most 18 months back. One call returns at most 6 calendar months: for a longer range, the answer stops at the end of the sixth month and next_start_date says where to continue.
end_datestringNoYYYY-MM-DD. Default: today (UTC). Cannot be in the future.
day_of_weekstringNoMONDAY…SUNDAY. Breakdown by day of the week; needs exactly one metric.
time_of_dayintNoHour 0–23. Breakdown by hour; needs exactly one metric. Not together with day_of_week.
Breakdowns

day_of_week and time_of_day map to Google's dailySubEntityType. Google's reference says that today no metric supports these breakdowns, so Google usually answers with an error (400 google_validation_error). They are exposed so that they work as soon as Google enables them.

Metrics​

Metric (Google name)Short aliasWhat it counts
BUSINESS_IMPRESSIONS_DESKTOP_MAPSimpressions_desktop_mapsProfile views on Google Maps, desktop.
BUSINESS_IMPRESSIONS_DESKTOP_SEARCHimpressions_desktop_searchProfile views on Google Search, desktop.
BUSINESS_IMPRESSIONS_MOBILE_MAPSimpressions_mobile_mapsProfile views on Google Maps, mobile.
BUSINESS_IMPRESSIONS_MOBILE_SEARCHimpressions_mobile_searchProfile views on Google Search, mobile.
CALL_CLICKScall_clicksClicks on the call button.
WEBSITE_CLICKSwebsite_clicksClicks on the website link.
BUSINESS_DIRECTION_REQUESTSdirection_requestsDirection requests.
MESSAGING_CLICKSmessaging_clicksClicks on the message or chat button (e.g. WhatsApp, SMS).
BUSINESS_FOOD_MENU_CLICKSfood_menu_clicksClicks to see the menu.
BUSINESS_BOOKINGSbookingsBookings made through Reserve with Google.
BUSINESS_FOOD_ORDERSfood_ordersDeprecated by Google, removed on 2027-04-22, no replacement. Only sent when you ask for it; the answer carries a warnings entry.

BUSINESS_CONVERSATIONS (alias conversations) was retired by Google: asking for it returns 400 metric_retired. Use MESSAGING_CLICKS.

Example Request​

curl 'https://api.upload-post.com/api/uploadposts/google-business/performance?user=agent-paris&metrics=call_clicks,website_clicks&start_date=2026-10-01&end_date=2026-10-31' \
-H 'Authorization: Apikey YOUR_API_KEY'

Successful Response (200 OK)​

series has one entry per day of the range (days Google did not report are 0); totals adds them up. end_date is the end of the range actually returned; when it is shorter than the one you asked for, call again with start_date=<next_start_date> (null when the range is complete). multiDailyMetricTimeSeries is Google's own object, as Google returns it (Google leaves value out when it is zero).

{
"success": true,
"location_id": "locations/111",
"start_date": "2026-10-01",
"end_date": "2026-10-31",
"next_start_date": null,
"metrics": ["CALL_CLICKS", "WEBSITE_CLICKS"],
"series": {
"CALL_CLICKS": [{ "date": "2026-10-01", "value": 3 }, { "date": "2026-10-02", "value": 0 }],
"WEBSITE_CLICKS": [{ "date": "2026-10-01", "value": 7 }, { "date": "2026-10-02", "value": 5 }]
},
"totals": { "CALL_CLICKS": 41, "WEBSITE_CLICKS": 160 },
"multiDailyMetricTimeSeries": [{
"dailyMetricTimeSeries": [
{ "dailyMetric": "CALL_CLICKS", "timeSeries": { "datedValues": [
{ "date": { "year": 2026, "month": 10, "day": 1 }, "value": "3" },
{ "date": { "year": 2026, "month": 10, "day": 2 } }
] } }
]
}],
"data_note": "Google publishes these numbers with a delay of several days: the last days can be 0."
}

With day_of_week or time_of_day the answer has breakdown, dailySubEntityType and timeSeries (Google's object) instead of multiDailyMetricTimeSeries.

Search keywords​

  • Method: GET
  • Endpoint: /api/uploadposts/google-business/performance/keywords

The search terms people typed on Google Search or Maps before seeing the profile, with the number of unique users per term added up over the months of the range. Google hides small numbers: those rows come with threshold ("fewer than N") instead of impressions.

ParameterTypeRequiredDescription
userstringYesThe profile username.
location_idstringNoSee "Which location?" above.
start_monthstringNoYYYY-MM. Default: the month of 29 days ago (or end_month if only that is sent). At most 18 months back.
end_monthstringNoYYYY-MM. Default: the current month. Cannot be in the future.
page_sizeintNo1–100 (default 100).
page_tokenstringNonext_page_token from the previous answer.
curl 'https://api.upload-post.com/api/uploadposts/google-business/performance/keywords?user=agent-paris&start_month=2026-09&end_month=2026-10&page_size=50' \
-H 'Authorization: Apikey YOUR_API_KEY'
{
"success": true,
"location_id": "locations/111",
"start_month": "2026-09",
"end_month": "2026-10",
"keywords": [
{ "search_keyword": "agence immobilière paris 11", "impressions": "120", "threshold": null },
{ "search_keyword": "dupont immobilier", "impressions": null, "threshold": "15" }
],
"searchKeywordsCounts": [
{ "searchKeyword": "agence immobilière paris 11", "insightsValue": { "value": "120" } },
{ "searchKeyword": "dupont immobilier", "insightsValue": { "threshold": "15" } }
],
"total_keywords": 212,
"truncated": false,
"next_page_token": "o50"
}

Up to 1,000 keywords are read per location and range. truncated: true means Google had more (or a later page failed this time; asking again later completes it).

Errors​

All errors carry success: false, a stable error_code (also in code) and a message.

Statuserror_codeWhen
400invalid_metric, metric_retiredUnknown or retired metric.
400invalid_date_range, invalid_month_rangeBad format, start after end, future end, or more than 18 months back.
400invalid_breakdownBad day_of_week/time_of_day, both at once, or more than one metric.
400invalid_page_size, invalid_page_tokenPaging values out of range.
400location_required, invalid_location_idSeveral locations and none chosen, or a malformed id.
404location_not_foundThe location is not in the Google Business account connected to the profile.
503location_check_unavailableThe location is not saved on the connection and Google's list of locations could not be read right now to check it; retry after retry_after_seconds.
400google_precondition_failed, google_validation_errorGoogle refused (e.g. the location is not verified).
401google_business_reconnect_requiredReconnect Google Business.
429daily_limit_reachedDaily limit of Google requests for your account reached. Ranges already read keep working; retry_after_seconds says when it resets.
429google_rate_limitedGoogle is limiting this account, or too many reads this minute; retry after retry_after_seconds.
502google_unreachable, google_api_errorGoogle did not answer or failed.
503gbp_feature_disabled, google_api_not_enabledTemporarily unavailable.