Início rápido: Utilizar o Python para chamar a API de Pesquisa na Web do Bing

Artigo
05/22/2020

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.

Utilize este início rápido para efetuar a sua primeira chamada à API de Pesquisa na Web do Bing. Esta aplicação Python envia um pedido de pesquisa para a API e mostra a resposta JSON. Embora esta aplicação esteja escrita em Python, a API é um serviço Web RESTful compatível com a maioria das linguagens de programação.

Este exemplo é executado como um bloco de notas do Jupyter no MyBinder. Para executá-lo, selecione o distintivo de enlace de iniciação:

Pré-requisitos

Python 2.x ou 3.x

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa na Web do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Definir variáveis

Substitua o valor subscription_key por uma chave de subscrição válida da sua conta do Azure.
```
subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key
```
Declarar o ponto final da API de Pesquisa na Web do Bing. Pode utilizar o ponto final global no seguinte código ou utilizar o ponto final de subdomínio personalizado apresentado no portal do Azure do recurso.
```
search_url = "https://api.bing.microsoft.com/v7.0/search"
```
Opcionalmente, personalize a consulta de pesquisa ao substituir o valor de search_term.
```
search_term = "Azure Cognitive Services"
```

Fazer um pedido

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

Para obter uma lista completa de opções e parâmetros, veja 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 apresentar a resposta

O search_results objeto inclui os resultados da pesquisa e metadados como consultas e páginas relacionadas. Este código utiliza a biblioteca IPython.display para formatar e apresentar a resposta no seu browser.

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 este código localmente, veja o exemplo completo disponível no GitHub.

Passos seguintes

Tutorial da aplicação de página única da API de Pesquisa na Web do Bing

Partilhar via