Listings APIListings API
Se connecter

Statistiques des profils Google, Facebook et Bing

Récupérez les métriques Google et Facebook par jour et les vues Bing par semaine d’un établissement : total mensuel et comparaison de deux périodes.

Les données analytiques des profils indiquent à quelle fréquence un établissement a été vu et a suscité des interactions sur chaque plateforme de publication : impressions, demandes d’itinéraire, appels et clics vers le site web. Chaque métrique est une série temporelle de points { startTime, value } ; les totaux que vous affichez sont donc ceux que vous calculez.

1. Lire les métriques Google pour une plage de dates

GET /locations/{locationId}/google-analytics?fromDate=&toDate= renvoie data.googleInsights avec une série quotidienne par métrique. total correspond aux impressions du profil, soit search plus maps ; cette métrique n’inclut pas les métriques d’action.

Google
curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"
JSON
{  "data": {    "googleInsights": {      "total": [        { "startTime": "2026-08-01T00:00:00+00:00", "value": 412 },        { "startTime": "2026-08-02T00:00:00+00:00", "value": 388 }      ],      "search": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 300 }],      "maps": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 112 }],      "directionsAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 24 }],      "phoneAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 8 }],      "websiteAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 41 }],      "businessBookings": null,      "businessFoodOrders": null,      "businessFoodMenuClicks": null    }  }}
SérieSignification
totalImpressions, search plus maps.
search, mapsImpressions dans Google Search et Google Maps.
directionsAction, phoneAction, websiteActionDemandes d’itinéraire, clics d’appel, clics vers le site web.
businessBookings, businessFoodOrders, businessFoodMenuClicksRéservations, commandes de repas et clics sur le menu, pour les profils qui les proposent.

Un identifiant d’établissement mal formé entraîne le renvoi de 200 avec googleInsights: null et un tableau errors, ce qui ressemble au résultat obtenu pour un profil déconnecté. Vérifiez d’abord errors.

2. Lire les métriques Facebook

GET .../facebook-analytics présente la même structure sous data.facebookInsights, avec cinq séries quotidiennes : views, ctaAction, directionsAction, phoneAction et websiteAction.

Facebook
curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/facebook-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"
JSON
{  "data": {    "facebookInsights": {      "views": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 120 }],      "ctaAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 5 }],      "directionsAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 3 }],      "phoneAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 2 }],      "websiteAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 9 }]    }  }}

ctaAction comptabilise les clics sur le bouton d’appel à l’action de la Page, ce qui vous permet de mesurer une campagne « Réserver maintenant » ou « Appeler maintenant ». Il n’existe aucune métrique pour les mentions J’aime de la Page.

3. Lire les vues Bing

GET .../bing-analytics renvoie une seule série, data.bingInsights.views, regroupée par semaine plutôt que par jour. Les données sont actualisées chaque lundi pour la semaine précédente ; récupérez donc une plage de plusieurs mois pour tracer une courbe de tendance.

Bing
curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2026-06-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"
JSON
{  "data": {    "bingInsights": {      "views": [        { "startTime": "2026-06-01T00:00:00+00:00", "value": 73 },        { "startTime": "2026-06-08T00:00:00+00:00", "value": 58 }      ]    }  }}

Contrairement à Google et Facebook, Bing signale l’absence de données par un tableau views vide plutôt que par null. Interprétez les deux cas comme « rien à afficher ».

4. Additionner les valeurs d’une série pour obtenir un total mensuel

Récupérez les données du mois, puis additionnez la valeur value de chaque point. Distinguez bien null de zéro : un profil déconnecté doit être indiqué comme « indisponible », et non comme un mois sans trafic. La page consacrée aux données analytiques du Node SDK propose la même fonction utilitaire sumSeries.

Monthly total
# jq: null when the metric is null, otherwise the sum of valuescurl -s "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY" \| jq '.data.googleInsights | { search: (if .search == null then null else ([.search[].value] | add) end),                               maps: (if .maps == null then null else ([.maps[].value] | add) end) }'

Bing nécessite une vérification supplémentaire : la somme d’un tableau views vide vaut 0 ; testez donc length == 0 si vous souhaitez afficher « aucune donnée » dans ce cas également.

5. Comparer deux périodes

Récupérez la même métrique pour deux plages de même durée et calculez la variation à partir des deux totaux. L’API ne propose aucune comparaison intégrée pour les données analytiques des profils ; les champs delta existent uniquement pour les données analytiques des avis.

Two periods
curl -s "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-07-01&toDate=2026-07-31" \-H "Authorization: API $LISTINGSAPI_KEY" | jq '[.data.googleInsights.total[].value] | add' curl -s "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY" | jq '[.data.googleInsights.total[].value] | add'

Prévoyez trois cas : l’une des périodes vaut null (profil non connecté), la période antérieure vaut 0 (division par zéro), et une plage est encore en cours, car un mois partiel comparé à un mois complet donne toujours l’impression d’une baisse. Chaque appel est comptabilisé dans votre limite de requêtes ; mettez donc les données de la période antérieure en cache plutôt que de les récupérer à chaque affichage.

Étapes suivantes