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>
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.
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
| Parameter | Type | Required | Description |
|---|---|---|---|
user | string | Yes | The profile username that owns the connected Google Business account. |
location_id | string | No | See "Which location?" above. |
metrics | string | No | Comma-separated metrics (see the table below). Default: all of them. Also accepted as metric. |
start_date | string | No | YYYY-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_date | string | No | YYYY-MM-DD. Default: today (UTC). Cannot be in the future. |
day_of_week | string | No | MONDAY…SUNDAY. Breakdown by day of the week; needs exactly one metric. |
time_of_day | int | No | Hour 0–23. Breakdown by hour; needs exactly one metric. Not together with day_of_week. |
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 alias | What it counts |
|---|---|---|
BUSINESS_IMPRESSIONS_DESKTOP_MAPS | impressions_desktop_maps | Profile views on Google Maps, desktop. |
BUSINESS_IMPRESSIONS_DESKTOP_SEARCH | impressions_desktop_search | Profile views on Google Search, desktop. |
BUSINESS_IMPRESSIONS_MOBILE_MAPS | impressions_mobile_maps | Profile views on Google Maps, mobile. |
BUSINESS_IMPRESSIONS_MOBILE_SEARCH | impressions_mobile_search | Profile views on Google Search, mobile. |
CALL_CLICKS | call_clicks | Clicks on the call button. |
WEBSITE_CLICKS | website_clicks | Clicks on the website link. |
BUSINESS_DIRECTION_REQUESTS | direction_requests | Direction requests. |
MESSAGING_CLICKS | messaging_clicks | Clicks on the message or chat button (e.g. WhatsApp, SMS). |
BUSINESS_FOOD_MENU_CLICKS | food_menu_clicks | Clicks to see the menu. |
BUSINESS_BOOKINGS | bookings | Bookings made through Reserve with Google. |
BUSINESS_FOOD_ORDERS | food_orders | Deprecated 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
user | string | Yes | The profile username. |
location_id | string | No | See "Which location?" above. |
start_month | string | No | YYYY-MM. Default: the month of 29 days ago (or end_month if only that is sent). At most 18 months back. |
end_month | string | No | YYYY-MM. Default: the current month. Cannot be in the future. |
page_size | int | No | 1–100 (default 100). |
page_token | string | No | next_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.
| Status | error_code | When |
|---|---|---|
| 400 | invalid_metric, metric_retired | Unknown or retired metric. |
| 400 | invalid_date_range, invalid_month_range | Bad format, start after end, future end, or more than 18 months back. |
| 400 | invalid_breakdown | Bad day_of_week/time_of_day, both at once, or more than one metric. |
| 400 | invalid_page_size, invalid_page_token | Paging values out of range. |
| 400 | location_required, invalid_location_id | Several locations and none chosen, or a malformed id. |
| 404 | location_not_found | The location is not in the Google Business account connected to the profile. |
| 503 | location_check_unavailable | The 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. |
| 400 | google_precondition_failed, google_validation_error | Google refused (e.g. the location is not verified). |
| 401 | google_business_reconnect_required | Reconnect Google Business. |
| 429 | daily_limit_reached | Daily limit of Google requests for your account reached. Ranges already read keep working; retry_after_seconds says when it resets. |
| 429 | google_rate_limited | Google is limiting this account, or too many reads this minute; retry after retry_after_seconds. |
| 502 | google_unreachable, google_api_error | Google did not answer or failed. |
| 503 | gbp_feature_disabled, google_api_not_enabled | Temporarily unavailable. |