Semak dokumentasi
Rujukan API
Google Images API
Diataskel Pencarian Google Images dan mendapatkan gambar asli URLs, thumbnail, dimensi dan halaman sumber sebagai JSON.
Bina permintaan
Parameter lanjutan
Mulai dari 1. Setiap halaman adalah permintaan terpisah.
Ekspresi tbs Google. Filter yang didukung bervariasi berdasarkan jenis pencarian.
https://data.flashdata.dev/v1/queries/realtimeParameter
Kirim source Dan query Di tingkat atas. Pilihan sumber termasuk dalam params. Bidang opsional dapat diabaikan.
Badan permintaan
sourcestring / Wajib- Ditetapkan untuk google_images.
querystring / Wajib- Pertanyaan pencarian. Sogodis Supports Google operator pencarian seperti situs: dan judul:.1 Ke 2,000 aksaraDefault:
Tidak Diset paramsobject / Pilihan- Settings untuk permintaan ini.Default:
{} callback_urlstring · nullable / Pilihan- Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.Default:
Tidak Diset
Kampung, bahasa & lokasi
params.glstring / Pilihan- Kode negara dua huruf, seperti kita, gb, de atau sg. Diatur secara eksplisit untuk memilih sebuah negara.Tepatnya 2 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^[A-Za-z]{2}$ params.hlstring / Pilihan- Google Bahasa antarmuka jaringan. [ Gambar di hlm.1 Ke 35 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^[A-Za-z0-9-]+$ params.locationstring / Pilihan- Yang diminta untuk mencari lokasi, lebih baik sebuah kota, seperti "London, England, United Kingdom". Ketersediaan tergantung pada jenis pencarian.1 Ke 200 aksaraDefault:
Tidak Diset
Kepinaran
params.numinteger / Pilihan- Hasil yang diminta dihitung. FlashData tidak menambahkan default tetap ketika diabaikan. Angka yang dikembalikan dapat berbeda menurut pertanyaan dan jenis pencarian.1 Ke 100, nomor bulatDefault:
Tidak Diset params.pageinteger / Pilihan- Halaman hasil yang dimintakan untuk diminta. Set secara eksplisit. Setiap halaman adalah permintaan API yang terpisah.1 Ke 100, nomor bulatDefault:
Tidak Diset
penapis pencarian fanfan
params.tbsstring / Pilihan- FANFA yang diminta filter pencarian Google, seperti qdr:d untuk hari terakhir atau qdr:w untuk minggu terakhir. Ketersediaan tergantung pada jenis pencarian.1 Ke 200 aksaraDefault:
Tidak Diset params.autocorrectboolean / Pilihan- Permintaan koreksi ejaan dengan trueQ atau meminta dinon-aktifkan dengan false. Perilaku yang diterapkan berdasarkan tipe pencarian; mengabaikan untuk menggunakan perilaku Google.
trueOR atau ORANGfalseDefault:Tidak Diset
Respons
Kembali Realtime status: done Diambil dari output pencarian results[0]. Padankan ada di results[0].images. usage.credits Catatan catatan biaya.
MazeimageUrl mengidentifikasi gambar asli; link mengidentifikasi halaman sumbernya. Dimensi gambar dan thumbnail adalah opsional. Hasil hasil hasil FILEN berisi URLs dan metadata, bukan berkas gambar.
Baca hasilnya
Simpan respon JSON yang sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan perpustakaan standar Python dan tidak membuat permintaan baru.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{"title": item.get("title"), "imageUrl": item.get("imageUrl"), "sourcePage": item.get("link")}
for item in result.get("images", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))Bidang-bidang yang tersedia tergantung pada jenis pertanyaan dan pencarian. Medan opsional mungkin tidak ada, dan ladang tambahan mungkin dikembalikan.
Jumlah barang yang dikembalikan dan searchParameters.num dapat berbeda dengan params.num. Anda menggunakan susunan yang dikembalikan untuk menentukan jumlah hasil yang sebenarnya.
Semua medan respon
| Ukrainian | Keterangan |
|---|---|
sourcestring | Sumber API yang diminta. |
statusstring | Hal ini dilakukan ketika permintaan realtime berhasil. |
created_atstring | Waktu penciptaan responsi kreasi dalam format ISO 8601. |
usage.creditsnumber | Penghargaan atas permintaan itu, berdasarkan rencanamu. |
results[0].searchParametersobject | Pengaturan pencarian visier dilaporkan oleh Google, dengan pertanyaan yang dicatat sebagai q. Pengaturan yang dikembalikan dapat berbeda dengan nilai yang diminta. |
results[0].imagesarray | Hasil pencarian gambar. |
results[0].images[].titlestring | Gelar Citra. |
results[0].images[].imageUrlstring | Gambar asli URL. |
results[0].images[].imageWidthinteger · optional | Lebar gambar asli dalam piksel. |
results[0].images[].imageHeightinteger · optional | Tinggi gambar asli dalam piksel. |
results[0].images[].thumbnailUrlstring · optional | thumbnail URL. |
results[0].images[].thumbnailWidthinteger · optional | Lebar thumbnail dalam piksel. |
results[0].images[].thumbnailHeightinteger · optional | Tinggi thumbnail dalam piksel. |
results[0].images[].linkstring | Halaman berisi gambar. |
results[0].images[].sourcestring · optional | Nama situs web Source. |
results[0].images[].domainstring · optional | Domain Sumber. |
results[0].images[].positioninteger | Posisi hasil. |
results[0].images[].googleUrlstring · optional | Hasil gambar Google Hasil gambar URL bila tersedia. |
Bidang-bidang di atas menggambarkan respon JSON baku. JSON, teks polos dan Markdown format.
Zavous Async & batch lifecycle
Surat penyerahan mengembalikan penerimaan, bukan hasil. Async menciptakan satu pekerjaan; batch mengembalikan pekerjaan yang terpisah dalam queries[] Untuk setiap pertanyaan yang diterima. Track dan mendapatkan setiap pekerjaan secara independen.
Diserahkan ke data.flashdata.dev; baca status pekerjaan dan hasil dari api.flashdata.dev Dan X-API-Key yang sama. Contoh dasar API terkait menggunakan Python dan cURL.
1. Simpan pekerjaan IDs
¡Holfi mempertahankan ruas permintaan sumber ini ketika beralih ke Async. Untuk Batch, letakkan setiap permintaan di dalam array kueri dari objek JSON. Simpan setiap pekerjaan yang dikembalikan ID.
2. Periksa status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: jajak pendapat dengan penundaan dan rasa hormatRetry-AfterKetika hadir.completed: Hasil tangkapan.failed: [ : ] inspeksijob.error.Read job.status, bukan status penerimaan.
Periksa status · Python dan cURL
Referensi API status Job3. Hasil kutipan
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsSelepas selesai, sahkan akses untuk membaca hasil, kemudian ambil URL storan daripada 302 tanpa kunci API anda. Simpan JSON dalam masa 24 jam selepas selesai.
Hasil kutip · Python dan cURL · Format respons
Hasil pengambilan gambar referensi API
Pengejaan dan pengambilan hasil yang sudah ada tidak mengkonsumsi kredit pertanyaan. TOPN TPS tidak membatalkan pekerjaan: menjaga ID daripada mengajukan pekerjaan yang dapat ditagih. Kode galat dan perilaku coba ulang dan kode galat.
Webhook penyelesaian
Langganan per pertanyaan
**Ditetapkan* callback_url Di tingkat atas dari permintaan async, atau lema di dalam setiap pertanyaan Di dalam kelompok, di luar params. Tidak ada permintaan pendaftaran-keuskupan webhook terpisah yang diperlukan. Permintaan Realtime tidak mengirim callback.
Use a public HTTPS URL di port 443. FlashData POSTs sebuah pemberitahuan untuk setiap jangkauan pekerjaan completed OR atau ORANG failed; BARV; acara tersebut berisi tautan, bukan hasil itu sendiri.
Mengakui dan memverifikasi
AWAS 2xx Setelah menerima acara itu dengan baik. Duakan duplikasi oleh delivery_id, Dan dikirim sebagai.. X-Delivery-Id. Redirect tidak diikuti.
Pengiriman Gagal dicoba dengan pengunduran eksponensial, hingga Total percobaan 8 Zain dan paling banyak 24 jam sesudah selesai. Tetap melakukan pemungutan suara sebagai kemunduran.
Panggilan balik tidak ditandatangani. Konfirmasi pekerjaan ID, sumber dan status terminal melalui Titik akhir status tersahihkan Bekal sebelum memproses pemberitahuan. Kiriman ID adalah untuk deduksi, bukan bukti keaslian.
Contoh senam webhook peristiwa dan bidang
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "google_images",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Ukrainian | Keterangan |
|---|---|
delivery_idstring | Pengenal pengiriman yang stabil. Pemberitahuan dundaplikasi menggunakan nilai ini; juga dikirim dalam header X-Delivery-Id. |
idstring | Yob ID. |
sourcestring | Sumber data yang dimintakan oleh KANTOR. |
statusstring | Gagal atau gagal. |
linksarray | Status dan hasil link. Pemakluman kata nifaks tidak termasuk konten hasil atau kunci API. |
links[].relstring | Kegandirian atau hasil. |
links[].hrefstring | Manajemen Absolute API URL; sahihkan dengan kunci API anda. |
links[].methodstring | GET. |
Pemulihan Galat
Pencarian yang telah selesai mungkin berisi lebih sedikit padanan daripada yang diminta. Periksa gl, hl, lokasi dan filter; pilihan kaya-result lapangan mungkin tidak hadir.
Untuk autentikasi, keseimbangan, permintaan-format dan tingkat-batas kegagalan, gunakan referensi kesalahan bersama. Pengerahan surat perintah mungkin masih menciptakan pekerjaan; memeriksa pekerjaan yang sudah ada sebelum mencoba lagi.
Ralat dan kod status · Bila hendak mencoba lagi · Batasan kadar laklak
Panduan langkah demi langkah: Pilih dan perbaiki pencarian Google
Harga
| Rencana | Kadar penggunaan terminologibagi setiap 1,000 permintaan | Langganan | Kredit yang disertakan per perioda penagihan |
|---|---|---|---|
| Bayar mengikut penggunaan | USD 1.00 | Tiada yuran bulanan | Tambah nilai apabila perlu |
| Micro | USD 0.80 | USD 49.00 / month | 1,000 Kerugian (USD 50.00 WOVE API penggunaan ) disertakan |
| Starter | USD 0.65 | USD 199.00 / month | 4,000 Kerugian (USD 200.00 WOVE API penggunaan ) disertakan |
| Pro | USD 0.60 | USD 499.00 / month | 10,000 Kerugian (USD 500.00 WOVE API penggunaan ) disertakan |
| Scale | USD 0.50 | USD 999.00 / month | 20,000 Kerugian (USD 1,000.00 WOVE API penggunaan ) disertakan |
| Business | USD 0.40 | USD 1,999.00 / month | 40,000 Kerugian (USD 2,000.00 WOVE API penggunaan ) disertakan |
Satu pelan akaun. Kredit dikongsi merentas ketiga-tiga produk. Penggunaan yang diliputi kredit pelan tidak dikenakan caj sekali lagi.
Harga dasar dan batas rencana