Cari alamat IP secara massal

Kirim daftar alamat IP ke satu endpoint dan terima daftar hasil lokasi yang sesuai. API pencarian IP massal Watch-IP menerima hingga 100 alamat IPv4 dan IPv6 per request untuk alur kerja pengayaan backend. Simpan secret key Anda di server, proses respons dalam urutan input, dan tangani record yang hilang tanpa kehilangan koneksi ke data asli Anda.

Lihat paket pencarian Bandingkan pencarian IP tunggal →

Satu request, hingga 100 alamat

Gunakan POST /v1/lookup dengan objek JSON yang berisi array ips. Setiap batch yang diterima berisi setidaknya satu alamat dan paling banyak 100, dan Anda bisa mencampur alamat IPv4 dan IPv6 yang valid dalam daftar yang sama. Respons membungkus hasil pencarian yang berurutan dalam array results; setiap hasil menggunakan bentuk pencarian IP tunggal, termasuk field found dan field lokasi yang bisa bernilai null.

Jaga hasil tetap sejajar dengan record sumber Anda

Untuk batch yang berhasil, API mengembalikan satu hasil untuk setiap alamat input dalam urutan yang sama. Simpan pengenal record Anda sendiri di samping daftar yang dikirim sehingga Anda bisa menggabungkan hasil kembali ke baris data asli Anda. Saat sebuah record tidak ditemukan, pertahankan barisnya dan tandai lokasi sebagai tidak tersedia; saat hanya satu field yang hilang, pertahankan sisa hasilnya. Jangan menggantikan koordinat yang hilang dengan nol, karena ini akan mengubah ketiadaan data menjadi lokasi peta yang menyesatkan.

Validasi sebelum mengirim

Daftar kosong, daftar yang lebih besar dari 100 alamat, atau IP yang tidak valid akan menghasilkan error request — satu alamat yang tidak valid menolak seluruh batch, bukan menghasilkan hasil sebagian-berhasil untuk sisa input. Validasi input dan bagi daftar yang panjang menjadi beberapa batch sebelum mengirimkannya, dan simpan catatan batch yang sudah selesai agar percobaan ulang tidak secara tidak sengaja mengulang seluruh pekerjaan.

Pahami apa yang berubah dengan batching

Batching mengurangi jumlah request HTTP yang dibutuhkan untuk mengirim daftar. Ini tidak mengubah sumber data, menambah field keamanan, atau mengubah 100 pencarian menjadi satu unit penggunaan — penggunaan pencarian dicatat per IP yang dikirim pada request yang diterima, jadi pemilihan paket harus mempertimbangkan total volume pencarian dan tingkat request. Rate limit per menit menghitung panggilan HTTP, bukan item: satu batch berisi hingga 100 IP atau alamat email dihitung sebagai satu request, sementara setiap item tetap dihitung terpisah terhadap batas request bulanan.

Bentuk request dan respons

ips: Isi request: array JSON berisi 1–100 alamat IPv4 atau IPv6.
results: Respons: array berurutan dengan satu entri per alamat input, dalam urutan yang sama saat dikirim.
results[].found, results[].country, ...: Setiap hasil menggunakan bentuk dan sifat null yang sama seperti respons pencarian IP tunggal — lihat halaman produk pencarian IP.

Kirim request batch

cURL — POST /v1/lookup

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'

Contoh alamat ini tidak menyiratkan nilai lokasi saat ini yang spesifik. Tetapkan WATCH_IP_SECRET_KEY di environment server Anda terlebih dahulu.

Pertanyaan yang sering diajukan

Berapa banyak alamat IP yang muat dalam satu batch?

Maksimum saat ini adalah 100. Bagi daftar yang lebih panjang menjadi beberapa request yang masing-masing berisi 1–100 alamat.

Bisakah satu batch berisi IPv4 dan IPv6 sekaligus?

Ya. Setiap alamat harus valid, dan cakupan database bisa berbeda menurut alamatnya.

Apakah hasil dikembalikan dalam urutan input?

Ya. Batch yang berhasil diterima mengembalikan satu hasil per alamat input dalam urutan yang sama.

Apa yang terjadi jika satu IP tidak valid?

Seluruh request ditolak. Validasi input Anda sebelum mengirim — endpoint ini tidak menyediakan keberhasilan sebagian untuk input yang tidak valid.

Apakah satu batch ditagih sebagai satu pencarian?

Tidak. Penggunaan diukur per IP. Tinjau harga pencarian saat ini dan contoh penagihan yang terverifikasi sebelum memperkirakan biaya pekerjaan besar.

Bisakah saya mengunggah file CSV?

Endpoint yang terdokumentasi menerima array JSON berisi alamat. Aplikasi Anda bisa membaca CSV-nya sendiri dan mengirim batch; antarmuka unggah CSV yang di-hosting bukan bagian dari API ini.

Apakah pencarian massal mencakup pengecekan VPN atau Tor?

Tidak. Respons massal saat ini adalah hasil lokasi database geolokasi pihak ketiga. Indikator keamanan visitor-geo adalah kemampuan terpisah yang tidak ada dalam respons pencarian.