Mulai cepat: Menggunakan Python untuk memanggil API Pencarian Web Bing

  • Artikel

Peringatan

Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke layanan Bing Search. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.

Gunakan mulai cepat ini untuk membuat panggilan pertama Anda ke API Pencarian Web Bing. Aplikasi Python ini mengirimkan permintaan pencarian ke API, dan menunjukkan respons JSON. Meskipun aplikasi ini ditulis dengan Python, API adalah layanan Web RESTful yang kompatibel dengan sebagian besar bahasa pemrograman.

Contoh ini dijalankan sebagai Jupyter notebook di MyBinder. Untuk menjalankannya, pilih lencana peluncuran pengikat:

Pengikat

Prasyarat

Membuat grup sumber daya Azure

Mulai gunakan Bing Web Search API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Search v7

  • Tersedia melalui portal Microsoft Azure hingga Anda menghapus sumber daya.
  • Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.

Sumber daya multilayanan

  • Tersedia melalui portal Microsoft Azure hingga Anda menghapus sumber daya.
  • Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa layanan Azure AI.

Tentukan variabel

  1. Ganti nilai subscription_key dengan kunci langganan yang valid dari akun Azure Anda.

    subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key

  2. Deklarasikan titik akhir API Pencarian Web Bing. Anda dapat menggunakan titik akhir global dalam kode berikut, atau menggunakan titik akhir subdomain kustom yang ditampilkan di portal Microsoft Azure untuk sumber daya Anda.

    search_url = "https://api.bing.microsoft.com/v7.0/search"

  3. Secara opsional, sesuaikan kueri pencarian dengan mengganti nilai untuk search_term.

    search_term = "Azure Cognitive Services"

Buat permintaan

Kode ini menggunakan pustaka requests untuk memanggil API Pencarian Web Bing dan mengembalikan hasilnya sebagai objek JSON. Kunci API diteruskan dalam kamus headers, dan parameter istilah dan kueri pencarian diteruskan dalam kamus params.

Untuk daftar lengkap opsi dan parameter, lihat API Pencarian Web 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()

Format dan Tampilkan respons

Objek search_results ini menyertakan hasil pencarian, dan metadata seperti kueri dan halaman terkait. Kode ini menggunakan pustaka IPython.display untuk memformat dan menampilkan respons di browser Anda.

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

Lihat sampel kode di GitHub

Untuk menjalankan kode ini secara lokal, lihat sampel lengkap yang tersedia di GitHub.

Langkah berikutnya

Tutorial aplikasi satu halaman Bing Web Search API

Lihat juga