Partilhar via

Como analisar os resultados das APIs de Pesquisa do Bing

  • Artigo

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja 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, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Quando envia uma chamada para as APIs da Web do Bing, Personalizada, Imagem, Notícias ou Pesquisa de Vídeos, o Bing devolve 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, aceda ao campo do objeto de totalEstimatedMatches resposta.

Por exemplo:

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

Paginar através dos resultados da pesquisa

Para analisar os resultados disponíveis, utilize os count parâmetros e offset de consulta ao enviar o pedido.

Nota

  • A paginação com as APIs de Vídeo, Imagem e Notícias do Bing aplica-se apenas a pesquisas gerais de vídeo (/video/search), notícias (/news/search) e imagens (/image/search). A paginação através de tópicos e categorias populares não é suportada.
  • O TotalEstimatedMatches campo é uma estimativa do número total de resultados da pesquisa para a consulta atual. Quando define os count parâmetros e offset , esta estimativa pode ser alterada.
Parâmetro Description
count Especifica o número de resultados a devolver na resposta. Tenha em atenção que o valor predefinido de counte o número máximo de resultados que pode pedir variam consondo a API. Pode encontrar estes valores na documentação de referência em Passos seguintes.
offset Especifica o número de resultados a ignorar. O offset é baseado em zero e deve ser menor que (totalEstimatedMatches - count).

Por exemplo, se quiser apresentar 15 resultados por página, deverá definir count como 15 e offset 0 para obter a primeira página de resultados. Para cada chamada à API subsequente, incrementaria offset em 15. O exemplo seguinte pede 15 páginas Web 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 utilizar o valor predefinido count , só tem de especificar o offset parâmetro de consulta nas 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 utilizar as APIs de Imagem e Vídeo do Bing, pode utilizar o nextOffset valor para evitar resultados de pesquisa duplicados. Obtenha o valor dos Images objetos ou Videos de resposta e utilize-o nos seus pedidos com o offset parâmetro .

Nota

A API de Pesquisa na Web do Bing devolve resultados de pesquisa que podem incluir páginas Web, imagens, vídeos e notícias. Quando percorre os resultados da pesquisa da API de Pesquisa na Web do Bing, está a paginar apenas Páginas Web e não outros tipos de resposta, como imagens ou notícias. Os resultados da pesquisa em WebPage objetos podem incluir resultados que também aparecem noutros tipos de resposta.

Se utilizar o responseFilter parâmetro de consulta sem especificar valores de filtro, não utilize os count parâmetros e offset .

Passos seguintes