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

2020-05-22

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.

Use este início rápido para fazer sua primeira chamada para a API de Pesquisa na Web do Bing. Este aplicativo Python envia uma solicitação de pesquisa para a API e mostra 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 no MyBinder. Para executá-lo, selecione o ícone de inicialização do Binder:

Pré-requisitos

Python 2.x ou 3.x

Criar um recurso do Azure

Comece a usar 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 plano de preços gratuito para experimentar o serviço, e depois mude para um plano pago para fins de 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, em vários serviços de IA do Azure.

Definir variáveis

Substitua o subscription_key valor por uma chave de assinatura válida de sua conta do Azure.
```
subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key
```
Declare o endpoint da API de Pesquisa na Web do Bing. Você pode usar o ponto de extremidade global no código a seguir ou usar 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 por search_term.
```
search_term = "Azure Cognitive Services"
```

Fazer uma solicitação

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

Para obter uma lista completa de opções e parâmetros, consulte a 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 search_results objeto inclui os resultados da pesquisa e metadados como consultas e páginas relacionadas. Esse código usa a IPython.display biblioteca para formatar e exibir a resposta no 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))

Código de exemplo no GitHub

Para executar esse código localmente, consulte 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