GuideGuías/Recetas/Retrieve profile analytics

Esta guía está disponible en inglés.

How do I retrieve profile analytics through the API?

Retrieve Profile Analytics via API

Pull Google Business Profile analytics with the Synup API, portfolio-wide or per location, with views, actions, calls and direction requests.

De un vistazo

Qué logra esta guía
Read profile views, actions, calls and direction requests for a client or a single location.
APIs utilizadas
Referencia
Análisis de perfil
Requisitos previos
  • An API key
  • A clientId, or a locationId for the per-location view
Casos de uso habituales
  • Showing a performance tab in your dashboard
  • Reporting monthly numbers to a business owner
  • Comparing locations against each other

There are two analytics calls, one wide and one deep. Reach for the wide one first. GET /api/v1/analytics/summary rolls up profile views, actions, website visits, calls, direction requests and button clicks across a client's locations, with a per-location leaderboard, a period comparison and daily, weekly or monthly granularity. One call covers a dashboard's overview and its per-location table.

curl "https://ai.synup.com/api/v1/analytics/summary?clientId=CLIENT_ID&comparison=previous_period&granularity=weekly" \
  -H "Authorization: Bearer $SYNUP_API_KEY"

GET /api/v1/analytics is the per-location version. It adds the Google search keywords that surfaced the profile and the maps-versus-search impression split, which the summary does not carry.

curl "https://ai.synup.com/api/v1/analytics?locationId=LOCATION_ID&clientId=CLIENT_ID" \
  -H "Authorization: Bearer $SYNUP_API_KEY"

Analytics only exist where a profile is connected and reporting, so a brand-new location shows nothing until Google starts returning metrics for it. Profile analytics is one of the six features in the local marketing guide; rank tracking is the SEO counterpart.