Obtener analíticas de Bing 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

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.

Response

{  "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.

Devuelve datos de visualizaciones del perfil de Bing Places de una ubicación. Las analíticas de Bing se agrupan por semana; cada punto de views representa el número de visualizaciones de una semana que comienza en startTime. Los datos se actualizan cada lunes con los de la semana anterior, por lo que verás la semana completa más reciente.

Cualquiera de los dos formatos de id funciona en la ruta

bing-analytics acepta el id Relay en Base64 (TG9jYXRpb246MTgwMDI4OQ==) o el id numérico sin codificar (1800289), y ambos corresponden a la misma ubicación. Utiliza preferentemente el id Relay, que es el que devuelven los endpoints de lectura. Si el valor no corresponde a ninguno de estos formatos, se devuelve {"data":{"bingInsights":null},"errors":[...]} con un estado 200 en lugar del objeto de métricas.

Shell

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

Seguimiento de las tendencias de visibilidad en Bing

Como Bing proporciona un valor por semana, este endpoint resulta más adecuado para una línea de tendencia que para la atribución diaria: consulta un intervalo de varios meses y representa views en un gráfico para ver si la visibilidad de la ficha en Bing aumenta o disminuye. Cuando la ubicación no tiene datos de Bing para ese intervalo (o su perfil de Bing no está conectado), el endpoint sigue devolviendo 200 con views como un array vacío ([]); interprétalo como "sin datos" en lugar de como un error. Combina estos datos con las analíticas de Google y Facebook para obtener un panel completo que abarque varias plataformas de publicación.