Insights API Overview

Overview

Use Insights API to request reports and analytics about how Maps users interact with your locations.

Only location owners and delegated partners may use Insights API.
Insights aren't available until at least 1 hour after a brand has been verified.
Report will be physically deleted after 31 days.
Organization may store a maximum of 100,000 requested reports on Apple Business. Recommended that users delete a report once successfully retrieved.
Only the system user that requested a report may retrieve the report.
For "Quick Report," the quantity of metrics (interval x reports) must not be more than 1000.
All data is reported in UTC or a location's local time zone.
Reports are aggregated by day, week (Sunday to Saturday), and month intervals except for spatial metrics and similar location metrics, which are available by month.
Up to 14 months of historical data is available for all reports. Spatial metrics are currently limited to brands located in the United States. Similar Location metrics are currently limited to brands in a subset of countries, and only if a sufficient number of similar locations are identified.
Usage metrics below a reporting threshold are represented as zero to protect the identity of individual users. Low usage will be more accurately reported using longer aggregation periods whose totals are more likely to exceed this threshold.
Usage metrics are only available for location categories that can be claimed.