Início Rápido: usar Python para chamar a API de Pesquisa na Web do Bing

Artigo
05/22/2020

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas 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.

Use este início rápido para fazer sua primeira chamada à API da Pesquisa na Web do Bing. Este aplicativo Python envia uma solicitação de pesquisa à API e exibe a resposta JSON. Embora esse aplicativo seja escrito em Python, a API é um serviço Web RESTful compatível com a maioria das linguagens de programação.

Este exemplo é executado como um Jupyter Notebook em MyBinder. Para executá-lo, selecione a notificação iniciar associador:

Pré-requisitos

Python 2.x ou 3.x

Criar um recurso do Azure

Comece usando a API de Pesquisa na Web do Bing criando um dos seguintes recursos do Azure:

Recurso de Pesquisa do Bing v7

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Definir variáveis

Substitua o valor subscription_key por uma chave de assinatura válida da sua conta do Azure.
```
subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key
```
Declare o ponto de extremidade da API de Pesquisa na Web do Bing. É possível usar o ponto de extremidade global no código a seguir ou o ponto de extremidade do subdomínio personalizado exibido no portal do Azure para seu recurso.
```
search_url = "https://api.bing.microsoft.com/v7.0/search"
```
Opcionalmente, personalize a consulta de pesquisa substituindo o valor para search_term.
```
search_term = "Azure Cognitive Services"
```

Fazer uma solicitação

Este código usa a biblioteca requests para chamar a API de Pesquisa na Web do Bing e retornar os resultados como um objeto JSON. A chave de API é passada no dicionário headers e os parâmetros de consulta e termo de pesquisa são passados no dicionário params.

Para obter uma lista completa de opções e parâmetros, confira API de Pesquisa na Web do Bing v7.

import requests

headers = {"Ocp-Apim-Subscription-Key": subscription_key}
params = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}
response = requests.get(search_url, headers=headers, params=params)
response.raise_for_status()
search_results = response.json()

Formatar e exibir a resposta

O objeto search_results inclui os resultados da pesquisa e esses metadados como consultas e as páginas relacionadas. Este código usa a biblioteca IPython.display para formatar e exibir a resposta no seu navegador.

from IPython.display import HTML

rows = "\n".join(["""<tr>
                       <td><a href=\"{0}\">{1}</a></td>
                       <td>{2}</td>
                     </tr>""".format(v["url"], v["name"], v["snippet"])
                  for v in search_results["webPages"]["value"]])
HTML("<table>{0}</table>".format(rows))

Exemplo de código no GitHub

Para executar esse código localmente, confira o exemplo completo disponível no GitHub.

Próximas etapas

Tutorial de aplicativo de página única da API de Pesquisa na Web do Bing

Compartilhar via