Snabbstart: Använda Python för att anropa API:et för webbsökning i Bing

2020-05-22

Varning

Den 30 oktober 2020 flyttade API:erna för Bing Search från Azure AI-tjänster till Bing Search Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing Search-resurs via Azure Marketplace.

Använd den här snabbstarten för att göra ditt första anrop till API:et för webbsökning i Bing. Det här Python-programmet skickar en sökbegäran till API:et och visar JSON-svaret. Även om det här programmet är skrivet i Python är API:et en RESTful-webbtjänst som är kompatibel med de flesta programmeringsspråk.

Det här exemplet körs som en Jupyter-anteckningsbok på MyBinder. Om du vill köra den väljer du startbindningsikonen:

Förutsättningar

Python 2.x eller 3.x

Skapa en Azure-resurs

Börja använda API:et för webbsökning i Bing genom att skapa någon av följande Azure-resurser:

resurs för Bing Search v7

Tillgänglig via Azure-portalen tills du tar bort resursen.
Använd den kostnadsfria prisnivån för att prova tjänsten och uppgradera senare till en betald nivå för produktion.

Resurs för flera tjänster

Tillgänglig via Azure-portalen tills du tar bort resursen.
Använd samma nyckel och slutpunkt för dina program i flera Azure AI-tjänster.

Definiera variabler

Ersätt värdet subscription_key med en giltig prenumerationsnyckel från ditt Azure-konto.
```
subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key
```
Deklarera API-slutpunkten för webbsökning i Bing. Du kan använda den globala slutpunkten i följande kod eller använda den anpassade underdomänen slutpunkt som visas i Azure-portalen för din resurs.
```
search_url = "https://api.bing.microsoft.com/v7.0/search"
```
Du kan också anpassa sökfrågan genom att ersätta värdet för search_term.
```
search_term = "Azure Cognitive Services"
```

Gör en begäran

Den här koden använder requests biblioteket för att anropa API:et för webbsökning i Bing och returnera resultatet som ett JSON-objekt. API-nyckeln skickas i headers ordlistan och söktermen och frågeparametrarna skickas i params ordlistan.

En fullständig lista över alternativ och parametrar finns i API för webbsökning i 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()

Formatera och visa svaret

Objektet search_results innehåller sökresultaten och till exempel metadata som relaterade frågor och sidor. Den här koden använder IPython.display biblioteket för att formatera och visa svaret i webbläsaren.

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))

Exempelkod på GitHub

Information om hur du kör den här koden lokalt finns i det fullständiga exemplet som är tillgängligt på GitHub.

Nästa steg

Handledning för Bing Web Search API en-sidars app

Dela via