Mulai cepat: Menggunakan Python untuk memanggil API Pencarian Web Bing
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:
Prasyarat
Membuat grup sumber daya Azure
Mulai gunakan Bing Web Search API dengan membuat salah satu sumber daya Azure berikut:
- 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.
- 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
Ganti nilai
subscription_key
dengan kunci langganan yang valid dari akun Azure Anda.subscription_key = "YOUR_ACCESS_KEY" assert subscription_key
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"
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.