Dela via


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

Varning

Den 30 oktober 2020 flyttade Bing-sökning API:er från Azure AI-tjänster till Bing-sökning 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-sökning 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:

Binder

Förutsättningar

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:

Bing-sökning v7-resurs

  • Tillgänglig via Azure Portal 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 Portal tills du tar bort resursen.
  • Använd samma nyckel och slutpunkt för dina program i flera Azure AI-tjänster.

Definiera variabler

  1. Ersätt värdet subscription_key med en giltig prenumerationsnyckel från ditt Azure-konto.

    subscription_key = "YOUR_ACCESS_KEY"
    assert subscription_key
    
  2. Deklarera slutpunkten för API för webbsökning i Bing. Du kan använda den globala slutpunkten i följande kod eller använda den anpassade underdomänslutpunkten som visas i Azure Portal för resursen.

    search_url = "https://api.bing.microsoft.com/v7.0/search"
    
  3. Du kan också anpassa sökfrågan genom att ersätta värdet för search_term.

    search_term = "Azure Cognitive Services"
    

Skapa 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 samt 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ökresultat och 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

Se även