Obtén datos analíticos de Facebook 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 Facebook Page interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the Page is not connected.

Response

{  "data": {    "facebookInsights": {      "views": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 120 }      ],      "ctaAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 5 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 3 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 2 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 9 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Devuelve datos diarios de interacción con la página de Facebook de una ubicación. Cada métrica es un array de puntos de una serie temporal con un startTime (el día en el que se agrupan los datos) y un value. Requiere que la página de Facebook de la ubicación esté conectada.

Métricas disponibles:

views: total de visualizaciones de la página
ctaAction: clics en el botón de llamada a la acción de la página
directionsAction: solicitudes de indicaciones para llegar a través de la página
phoneAction: llamadas iniciadas desde la página
websiteAction: clics que llevan al sitio web desde la página

Ambas formas de id funcionan en la ruta

Al igual que los demás endpoints de análisis, facebook-analytics acepta el id Relay en Base64 (TG9jYXRpb246MTgwMDI4OQ==) o el id numérico sin codificar (1800289), y ambos identifican la misma ubicación. Da preferencia al id Relay, que es el que devuelven los endpoints de lectura. Si el valor no corresponde a ninguna de las dos formas, se devuelve {"data":{"facebookInsights":null},"errors":[...]} con un estado 200.

Shell

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

Atribución de interacciones al botón CTA

Cuando una ubicación utiliza una llamada a la acción «Reserva ahora» o «Llama ahora» en su página, ctaAction y phoneAction te permiten cuantificar cuántos de esos clics generó el botón durante el periodo de una campaña. Ten en cuenta que cada métrica se devuelve como null (no como un array vacío) cuando la página no tiene datos para el intervalo o no está conectada; comprueba si el valor es null antes de iterar. Combina estos datos con los análisis de Google y Bing para crear una vista única del rendimiento en varias plataformas de publicación.