Quickstart: Nieuws zoeken met behulp van Python en de REST API voor Bing News Search
Waarschuwing
Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.
Gebruik deze quickstart om uw eerste aanroep naar de Bing Nieuws zoeken-API te maken. Met deze eenvoudige Python-toepassing wordt een zoekquery naar de API verzonden en wordt het JSON-resultaat verwerkt.
Hoewel deze toepassing in Python is geschreven, is de API een RESTful-webservice die compatibel is met vrijwel elke programmeertaal.
Als u dit voorbeeld als een Jupyter-notebook op MyBinder wilt uitvoeren, selecteert u de badge Binder starten:
De broncode voor dit voorbeeld is ook beschikbaar op GitHub.
Een Azure-resource maken
Begin met het gebruik van de Bing News Search-API door een van de volgende Azure-resources te maken:
- Beschikbaar via de Azure-portal totdat u de resource verwijdert.
- Gebruik de gratis prijscategorie om de service uit te proberen, en voer later een upgrade uit naar een betaalde categorie voor productie.
Resource voor meerdere services
- Beschikbaar via de Azure-portal totdat u de resource verwijdert.
- Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.
De toepassing maken en initialiseren
Maak een nieuw Python-bestand in uw favoriete IDE of editor en importeer de aanvraagmodule. Maak variabelen voor uw abonnementssleutel, eindpunt en zoekterm. U kunt het globale eindpunt in de volgende code gebruiken of het eindpunt voor een aangepast subdomein gebruiken dat wordt weergegeven in de Azure-portal voor uw resource.
import requests
subscription_key = "your subscription key"
search_term = "Microsoft"
search_url = "https://api.cognitive.microsoft.com/bing/v7.0/news/search"
Parameters voor de aanvraag maken
Voeg uw abonnementssleutel toe aan een nieuwe woordenlijst en gebruik Ocp-Apim-Subscription-Key
daarbij als sleutel. Doe hetzelfde voor uw zoekparameters.
headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
params = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}
Een aanvraag verzenden en een antwoord ontvangen
Gebruik de aanvraagbibliotheek om de Bing Visual Search-API aan te roepen met uw abonnementssleutel, net als de woordenlijstobjecten die u in de vorige stap hebt gemaakt.
response = requests.get(search_url, headers=headers, params=params) response.raise_for_status() search_results = json.dumps(response.json())
Bekijk de beschrijvingen van de artikelen die zijn opgenomen in het antwoord van de API, die is opgeslagen in
search_results
als een JSON-object.descriptions = [article["description"] for article in search_results["value"]]
De resultaten weergeven
Deze beschrijvingen kunnen vervolgens worden weergegeven als een tabel met het zoekwoord vet gemarkeerd.
from IPython.display import HTML
rows = "\n".join(["<tr><td>{0}</td></tr>".format(desc)
for desc in descriptions])
HTML("<table>"+rows+"</table>")