Bing Webmaster Tools

Dados de desempenho na Pesquisa do Bing (cliques, impressões, CTR e posições médias) do site do Bing Webmaster Tools ligado a um projeto. Requer o plano Growth ou superior. Nenhum destes endpoints contacta o Bing: todos leem o que a sincronização diária guardou, cerca de 13 meses de histórico. ctr é uma fração entre 0 e 1. O resumo e as séries temporais provêm dos totais diários do site fornecidos pelo Bing, que não incluem a posição. As principais consultas e páginas provêm dos valores semanais do Bing: cada linha soma as semanas cujo week_ending (a sexta-feira que encerra uma semana do Bing) se situa no intervalo, e o Bing só comunica as principais linhas de cada semana, cerca de 100, pelo que a soma dessas linhas nunca corresponde aos totais. history_current é false entre uma mudança de site em Preferências > Definições do projeto > Ligações e a primeira sincronização posterior; até lá, todas as leituras devolvem resultados vazios. Os projetos sem um site ligado devolvem ERR_BING_WEBMASTER_NOT_CONNECTED (404) com meta.connect_url.

GET/bing_webmaster/summary

Cliques, impressões e ctr do site no intervalo, somados a partir dos totais diários do Bing. data_through é o último dia sincronizado; os dias posteriores estão em falta, não a zero.

Parâmetros:
  • project_idobrigatório
  • range
  • from
  • to

GET/bing_webmaster/timeseries

Cliques, impressões e ctr agrupados por dia, semana (a começar à segunda-feira) ou mês. Os dias sem dados sincronizados ficam de fora da série.

Parâmetros:
  • project_idobrigatório
  • range
  • from
  • to
  • granularityday|week|month
  • outputflat|csv

GET/bing_webmaster/queries

Principais consultas de pesquisa do Bing, ordenadas e paginadas, cada uma com os valores somados das semanas do Bing cujo week_ending se situa no intervalo. Cada linha inclui cliques, impressões, ctr, avg_impression_position (ponderada pelas impressões) e avg_click_position (ponderada pelos cliques e null quando não há cliques). weeks_covered conta as semanas encontradas e data_through é a última semana sincronizada.

Parâmetros:
  • project_idobrigatório
  • range
  • from
  • to
  • sortimpressions|clicks|ctr|avg_impression_position|avg_click_position
  • page
  • per_page
  • outputflat|csv

GET/bing_webmaster/pages

As páginas de destino do site na Pesquisa do Bing, ordenadas e paginadas, cada uma com os valores somados das semanas do Bing cujo week_ending se situa no intervalo. O mesmo formato do endpoint de consultas, em que a chave de cada linha é um URL de página.

Parâmetros:
  • project_idobrigatório
  • range
  • from
  • to
  • sortimpressions|clicks|ctr|avg_impression_position|avg_click_position
  • page
  • per_page
  • outputflat|csv