Obter análises do Bing para um local

Parâmetros

Caminho

Nome	Tipo	Obrigatório	Descrição
locationId	string	obrigatório	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.

Query

Nome	Tipo	Obrigatório	Descrição	Padrão
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).	—

Respostas

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.

Retorna dados de visualizações do perfil no Bing Places para um local. As análises do Bing são agrupadas por semana; cada ponto em views representa a contagem de visualizações de uma semana com início em startTime. Os dados são atualizados toda segunda-feira com os dados da semana anterior, portanto você verá a semana completa mais recente.

Qualquer uma das formas de id funciona no caminho

bing-analytics aceita o id Relay em Base64 (TG9jYXRpb246MTgwMDI4OQ==) ou o id numérico bruto (1800289), e ambos correspondem ao mesmo local. Prefira o id Relay, que é o retornado pelos endpoints de leitura. Um valor que não corresponda a nenhuma dessas formas resulta no retorno de {"data":{"bingInsights":null},"errors":[...]} com status 200 em vez do 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"

Acompanhar tendências de visibilidade no Bing

Como o Bing informa um valor por semana, este endpoint é mais adequado para uma linha de tendência do que para atribuição diária: consulte um intervalo de vários meses e trace um gráfico de views para verificar se a visibilidade da listagem no Bing está aumentando ou diminuindo. Quando o local não tem dados do Bing para o período (ou seu perfil no Bing não está conectado), o endpoint ainda retorna 200 com views como um array vazio ([]); trate isso como "sem dados", e não como um erro. Combine com as análises do Google e do Facebook para obter um painel completo com várias plataformas de publicação.