/api/v4/locations/{locationId}/bing-analyticsObtenir les données analytiques Bing d’un établissement
Renvoie les métriques hebdomadaires de consultation du profil Bing Places d’un établissement sur une plage de dates.
Paramètres
Chemin
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| locationId | string | obligatoire | 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. |
Chaîne de requête
| Nom | Type | Obligatoire | Description | Par défaut |
|---|---|---|---|---|
| fromDate | string | facultatif | Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted. | — |
| toDate | string | facultatif | End of the range (YYYY-MM-DD). | — |
Réponses
200Weekly Bing view metrics. `views` is a time-series array; it is empty when no data exists for the range or the Bing profile is not connected.
{ "data": { "bingInsights": { "views": [ { "startTime": "2025-06-02T00:00:00+00:00", "value": 73 }, { "startTime": "2025-06-09T00:00:00+00:00", "value": 58 } ] } }}401Unauthenticated, missing or invalid API key.
Renvoie les données de consultation du profil Bing Places d’un établissement. Les données analytiques Bing sont regroupées par semaine : chaque point de views représente le nombre de consultations sur une semaine à partir de startTime. Les données sont actualisées chaque lundi pour la semaine précédente ; vous verrez donc les données de la dernière semaine complète.
Les deux formes d’id fonctionnent dans le chemin
bing-analytics accepte l’id Relay en Base64 (TG9jYXRpb246MTgwMDI4OQ==) ou l’id numérique brut (1800289), et les deux désignent le même établissement. Privilégiez l’id Relay, qui est celui que renvoient les endpoints de lecture. Une valeur qui ne correspond à aucune de ces deux formes entraîne le renvoi de {"data":{"bingInsights":null},"errors":[...]} avec un statut 200 plutôt que de l’objet contenant les métriques.
curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2025-01-01&toDate=2025-12-31' \ -H "Authorization: API $LISTINGSAPI_KEY"Suivre les tendances de visibilité sur Bing
Comme Bing fournit une valeur par semaine, cet endpoint convient mieux au suivi d’une tendance qu’à l’attribution à l’échelle d’une journée : récupérez les données sur plusieurs mois et tracez views pour voir si la visibilité de la fiche sur Bing augmente ou diminue. Lorsque l’établissement ne dispose d’aucune donnée Bing pour la période (ou que son profil Bing n’est pas connecté), l’endpoint renvoie tout de même 200 avec views sous forme de tableau vide ([]) ; interprétez ce résultat comme une « absence de données » plutôt que comme une erreur. Combinez ces données avec les données analytiques Google et Facebook pour obtenir un tableau de bord complet couvrant plusieurs plateformes de publication.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/bing-analytics' \ -H "Authorization: API $LISTINGSAPI_KEY"