Listings APIListings API
Accedi
GET/api/v4/locations/{locationId}/facebook-analytics

Ottieni i dati analitici di Facebook per una sede

Restituisce le metriche giornaliere di interazione con la Pagina Facebook di una sede per un intervallo di date.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Percorso

NomeTipoObbligatorioDescrizione
locationIdstringobbligatorioLocation 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.

Query

NomeTipoObbligatorioDescrizionePredefinito
fromDatestringfacoltativoStart of the range (YYYY-MM-DD). Defaults to a recent window when omitted.—
toDatestringfacoltativoEnd of the range (YYYY-MM-DD).—

Risposte

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.

Restituisce i dati giornalieri di interazione con la Pagina Facebook di una sede. Ogni metrica è un array di punti di una serie temporale con un startTime (il giorno di raggruppamento) e un value. Richiede che la Pagina Facebook della sede sia collegata.

Metriche disponibili:

  • views: visualizzazioni totali della Pagina
  • ctaAction: clic sul pulsante di invito all'azione della Pagina
  • directionsAction: richieste di indicazioni stradali tramite la Pagina
  • phoneAction: chiamate avviate dalla Pagina
  • websiteAction: clic dalla Pagina verso il sito web

Entrambi i formati di id funzionano nel percorso

Come gli altri endpoint di analisi, facebook-analytics accetta l'id Relay in Base64 (TG9jYXRpb246MTgwMDI4OQ==) o l'id numerico grezzo (1800289), ed entrambi identificano la stessa sede. Preferisci l'id Relay, che è quello restituito dagli endpoint di lettura. Se il valore non corrisponde a nessuno dei due formati, l'endpoint restituisce {"data":{"facebookInsights":null},"errors":[...]} con uno stato 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"

Attribuire le interazioni al pulsante CTA

Quando una sede utilizza un invito all'azione "Prenota ora" o "Chiama ora" sulla propria Pagina, ctaAction e phoneAction ti consentono di quantificare quanti di quei clic sono stati generati dal pulsante durante il periodo di una campagna. Tieni presente che ogni metrica viene restituita come null (non come un array vuoto) quando la Pagina non ha dati per l'intervallo o non è collegata; verifica la presenza di null prima di eseguire un'iterazione. Combina questi dati con i dati analitici di Google e Bing per creare una vista unica delle prestazioni su più piattaforme di pubblicazione.

Request
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/facebook-analytics' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground