v1Resources/Profile Analytics/getGet profile analytics
Get profile analytics
Returns profile view/action metrics for one location over a date range, aggregated per connected source (Google, Facebook, Apple, Bing).
get
analytics:read/api/v1/analyticsQuery parameters
locationIdstringrequired
The location to look up.
clientIdstringrequired
The location's client.
fromstringoptional
Start date (YYYY-MM-DD) of the range. Optional — defaults to the source's standard window.
tostringoptional
End date (YYYY-MM-DD) of the range. Optional.
Response
dataobjectoptional
connectedSourcesarray of string (google | facebook | apple | bing)optional
Which platforms this location has connected: google, facebook, apple, bing.
summarystringoptional
A short human-readable summary of performance, or null.
syncedAtstringoptional
When this data was last synced, as an ISO 8601 timestamp, or null.
latestDataDaystringoptional
Most recent day with data, as YYYY-MM-DD, or null.
profileViewsobjectoptional
Profile view counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
allActionsobjectoptional
All customer actions (calls, direction requests, website visits, button clicks) combined, over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
websiteVisitsobjectoptional
Website visit counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
phoneCallsobjectoptional
Phone call counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
directionRequestsobjectoptional
Direction request counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
buttonClicksobjectoptional
Other profile button click counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
followersobjectoptional
Facebook follower counts over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
postEngagementobjectoptional
Facebook post engagement over time.
metricstringoptional
Name of the metric.
totalnumberoptional
Total for the selected range, or null.
previousTotalnumberoptional
Total for the prior comparable range, or null.
labelsarray of stringoptional
Date labels for each point in the series.
bySourceobjectoptional
Per-day values broken out by connected source.
searchKeywordsarray of objectoptional
Search terms that surfaced this listing, Google only.
keywordstringoptional
The search term.
impressionsnumberoptional
Number of impressions for this term.
keywordMonthsobjectoptional
Date range the search keywords cover, or null.
fromstringoptional
tostringoptional
impressionSplitobjectoptional
Breakdown of impressions by surface, Google only, or null.
mapsnumberoptional
Impressions on Google Maps.
searchnumberoptional
Impressions on Google Search.
desktopnumberoptional
Impressions on desktop.
mobilenumberoptional
Impressions on mobile.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/analytics
Your API key
locationId *
clientId *
from
to
{
"data": {
"connectedSources": [
"google"
],
"summary": "Profile views are up 12% this month.",
"syncedAt": "2026-02-01T00:00:00.000Z",
"latestDataDay": "2026-01-31",
"profileViews": {
"metric": "Profile Views",
"total": 1200,
"previousTotal": 1050,
"labels": [
"2026-01-01",
"2026-01-31"
],
"bySource": {
"google": [
40,
42
]
}
},
"allActions": {
"metric": "All Actions",
"total": 300,
"previousTotal": 280,
"labels": [],
"bySource": {}
},
"websiteVisits": {
"metric": "Website Visits",
"total": 150,
"previousTotal": 140,
"labels": [],
"bySource": {}
},
"phoneCalls": {
"metric": "Phone Calls",
"total": 60,
"previousTotal": 55,
"labels": [],
"bySource": {}
},
"directionRequests": {
"metric": "Direction Requests",
"total": 90,
"previousTotal": 85,
"labels": [],
"bySource": {}
},
"buttonClicks": {
"metric": "Button Clicks",
"total": 20,
"previousTotal": 18,
"labels": [],
"bySource": {}
},
"followers": {
"metric": "Followers",
"total": null,
"previousTotal": null,
"labels": [],
"bySource": {}
},
"postEngagement": {
"metric": "Post Engagement",
"total": null,
"previousTotal": null,
"labels": [],
"bySource": {}
},
"searchKeywords": [
{
"keyword": "dentist near me",
"impressions": 320
}
],
"keywordMonths": {
"from": "2026-01-01",
"to": "2026-01-31"
},
"impressionSplit": {
"maps": 600,
"search": 900,
"desktop": 500,
"mobile": 1000
}
}
}