Obtener analíticas de Google para una ubicación

Parámetros

Ruta

Nombre	Tipo	Obligatorio	Descripción
locationId	string	obligatorio	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

Consulta

Nombre	Tipo	Obligatorio	Descripción	Predeterminado
fromDate	string	opcional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	opcional	End of the range (YYYY-MM-DD).	—

Respuestas

200Daily Google interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the profile is not connected.

Response

{  "data": {    "googleInsights": {      "total": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 412 },        { "startTime": "2025-06-02T00:00:00+00:00", "value": 388 }      ],      "search": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 300 }      ],      "maps": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 112 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 24 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 8 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 41 }      ],      "businessBookings": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodOrders": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodMenuClicks": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Devuelve datos diarios de interacción de Google Business Profile para una ubicación. Cada métrica es un array de puntos de una serie temporal, donde cada punto tiene un startTime (el día en el que se agrupa el recuento) y un value.

Métricas disponibles:

total: impresiones totales del perfil, search más maps. No incluye las métricas de acciones que se indican a continuación, por lo que, en el ejemplo anterior, 412 = 300 de búsquedas + 112 de mapas.
search: impresiones en los resultados de Google Search (ordenadores y móviles combinados)
maps: impresiones en los resultados de Google Maps (ordenadores y móviles combinados)
directionsAction: solicitudes de indicaciones para llegar a la ubicación
phoneAction: clics en el botón de llamada
websiteAction: clics para acceder al sitio web
businessBookings: reservas iniciadas desde el perfil
businessFoodOrders: pedidos de comida realizados desde el perfil
businessFoodMenuClicks: clics en el enlace al menú de comida

Cualquiera de los dos formatos de id funciona en la ruta

Tanto 1800289 como TG9jYXRpb246MTgwMDI4OQ== corresponden a la misma ubicación. Usa preferentemente el id de Relay en Base64: es el que devuelven todos los endpoints de lectura y el formato que acepta el resto de la API. Un valor que no sea ni un número ni un id de Relay decodificable da lugar a una respuesta 200 cuyo cuerpo es {"data":{"googleInsights":null},"errors":[...]}, lo que puede confundirse fácilmente con un fallo del servidor.

Shell

curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2025-06-01&toDate=2025-06-30' \  -H "Authorization: API $LISTINGSAPI_KEY"

Informar sobre el impacto de una actualización de datos

Un uso habitual es un informe de visibilidad de antes y después: tras enviar cambios de horario o categoría a una ubicación, consulta periódicamente google-analytics para las semanas anteriores y posteriores al cambio y representa gráficamente search + maps para mostrar el aumento. Las métricas individuales se devuelven como null (en lugar de un array vacío) cuando la ubicación no tiene datos de Google para el periodo solicitado o su perfil de Google no está conectado; trata null y [] de la misma manera al agregar los datos. Combina estos datos con las analíticas de Facebook y Bing para obtener una visión que abarque varias plataformas de publicación.