Início Rápido: Executar uma pesquisa de notícias usando o Python e a API REST da Pesquisa de Notícias do Bing

Use este início rápido para fazer sua primeira chamada para a API de Pesquisa de Notícias do Bing. Este aplicativo Python simples envia uma consulta de pesquisa para a API e processa o resultado 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.

Para executar este exemplo de código como um Jupyter notebook no MyBinder, selecione o selo launch binder:

O código-fonte deste exemplo também está disponível no GitHub.

Criar um recurso do Azure

Comece a usar a API de Pesquisa de Notícias 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.

Criar e inicializar o aplicativo

Crie um novo arquivo Python em seu IDE ou editor favorito e importe o módulo de solicitação. Para a chave de assinatura, o ponto de extremidade e o termo de pesquisa, crie variáveis. 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.

import requests

subscription_key = "your subscription key"
search_term = "Microsoft"
search_url = "https://api.cognitive.microsoft.com/bing/v7.0/news/search"

Criar parâmetros para a solicitação

Adicione sua chave de assinatura a um novo dicionário, usando Ocp-Apim-Subscription-Key como chave. Faça o mesmo para seus parâmetros de pesquisa.

headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
params  = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}

Enviar uma solicitação e obter uma resposta

1. Use a biblioteca de solicitações para chamar a API de Pesquisa Visual do Bing com sua chave de assinatura e os objetos de dicionário que você criou na etapa anterior.

   response = requests.get(search_url, headers=headers, params=params)
   response.raise_for_status()
   search_results = json.dumps(response.json())
   

2. Acesse as descrições dos artigos contidos na resposta da API, que é armazenada como search_results um objeto JSON.

   descriptions = [article["description"] for article in search_results["value"]]
   

Exibir os resultados

Essas descrições podem ser renderizadas como uma tabela com a palavra-chave de pesquisa realçada em negrito.

from IPython.display import HTML
rows = "\n".join(["<tr><td>{0}</td></tr>".format(desc)
                  for desc in descriptions])
HTML("<table>"+rows+"</table>")

Próximas etapas