Compartilhar via

Como analisar os resultados das APIs de Pesquisa do Bing

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram transferidas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

Quando você envia uma chamada para as APIs de Pesquisa da Web, Personalizada, Imagem, Notícias ou Vídeo do Bing, o Bing retorna um subconjunto do número total de resultados que podem ser relevantes para a consulta. Para obter o número total estimado de resultados disponíveis, acesse o campo de resposta do objeto totalEstimatedMatches.

Por exemplo:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    }
}

Visualizando os resultados da pesquisa

Para percorrer os resultados disponíveis, use os parâmetros de consulta count e offset ao enviar sua solicitação.

Observação

  • A paginação com as APIs de Vídeo, Imagem e Notícias do Bing aplica-se somente a pesquisas gerais de vídeo (/video/search), notícias (/news/search) e imagem (/image/search). A navegação por tópicos e categorias em alta não é suportada.
  • O TotalEstimatedMatches campo é uma estimativa do número total de resultados da pesquisa para a consulta atual. Quando você define o parâmetro count e o parâmetro offset, essa estimativa pode mudar.
Parâmetro Descrição
count Especifica o número de resultados a serem retornados na resposta. Observe que o valor padrão e counto número máximo de resultados que você pode solicitar variam de acordo com a API. Você pode encontrar esses valores na documentação de referência nas próximas etapas.
offset Especifica o número de resultados a serem ignorados. O offset é baseado em zero e deve ser menor que (totalEstimatedMatches - count).

Por exemplo, se você quiser exibir 15 resultados por página, definirá count como 15 e offset 0 para obter a primeira página de resultados. Para cada chamada à API subsequente, você incrementaria offset em 15. O exemplo a seguir solicita 15 páginas da Web, começando a partir do deslocamento 45.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Se você usar o valor padrão count , só precisará especificar o offset parâmetro de consulta em suas chamadas à API.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Ao usar as APIs de Imagem e Vídeo do Bing, você pode usar o nextOffset valor para evitar resultados de pesquisa duplicados. Obtenha o valor dos objetos ou Images da resposta e use-o Videos em suas solicitações com o offset parâmetro.

Observação

A API de Pesquisa na Web do Bing retorna resultados de pesquisa que podem incluir páginas da Web, imagens, vídeos e notícias. Ao analisar os resultados da pesquisa da API de Pesquisa na Web do Bing, você está paginando apenas Páginas da Web e não outros tipos de resposta, como imagens ou notícias. Os resultados da pesquisa em WebPage objetos também podem incluir resultados que aparecem em outros tipos de resposta.

Se você usar o parâmetro de consulta responseFilter sem especificar nenhum valor de filtro, não use os parâmetros count e offset.

Próximas etapas