Cari alamat IP dari backend Anda

Selesaikan alamat IP yang Anda kirim menjadi data negara, wilayah, kota, dan koordinat perkiraan yang tersedia. API pencarian IP Watch-IP menerima input IPv4 dan IPv6 serta mengembalikan hasil JSON yang didukung oleh database geolokasi IP pihak ketiga. Gunakan secret API key di server Anda, dan bangun aplikasi Anda mengelilingi kecocokan eksplisit, record yang hilang, dan field lokasi yang bisa bernilai null.

Lihat paket pencarian Diskusikan akses pencarian →

Kirim alamat yang ingin Anda selesaikan

Panggil GET /v1/lookup/{ip} dengan alamat IP yang dikumpulkan oleh aplikasi Anda, diautentikasi dengan Authorization: Bearer dan secret key. Pencarian ini menyelesaikan alamat pada URL, bukan koneksi yang digunakan untuk membuat request, sehingga cocok untuk alur kerja backend yang sudah berisi alamat IP, termasuk pelaporan dan pengayaan regional. Pastikan bagaimana aplikasi Anda mendapatkan IP pengguna akhir sebelum mengandalkan header forwarded; percayai hanya jalur proxy yang Anda kendalikan sendiri. Untuk integrasi pengunjung situs web biasa, endpoint geolokasi browser menawarkan jalur berbeda dengan publishable key dan pengayaan regional.

Beralih dari satu alamat ke batch

Jika alur kerja Anda berisi beberapa alamat IP, endpoint batch menerima hingga 100 alamat dalam satu request dan mengembalikan hasil dalam urutan yang sama. Endpoint ini menggunakan bentuk hasil pencarian yang sama dan model autentikasi secret-key sisi server yang sama. Batching mengubah cara Anda mengirim request — penggunaan pencarian tetap diukur per IP, jadi satu batch bukan satu unit penggunaan pencarian.

Bangun di sekitar data perkiraan

Sebuah IP dapat mewakili gateway bersama, jaringan hosting, exit VPN, atau koneksi operator seluler. Record lokasi bisa tidak lengkap atau berbeda antar penyedia data. Gunakan hasil pencarian sebagai konteks untuk alamat yang Anda kirim, bukan bukti tempat tinggal atau identitas seseorang.

Field respons

ip: Alamat input yang terkait dengan hasil ini.
found: Apakah record database yang cocok ditemukan. False juga bisa berarti database tidak tersedia atau belum termuat — ini tidak membuktikan alamat tersebut tidak memiliki data lokasi.
country, continent: Kode negara dan benua, jika tersedia.
region: Pengenal subdivisi dari pemetaan saat ini, tidak selalu berupa nama wilayah lengkap.
city, latitude, longitude: Perkiraan kota dan koordinat, jika tersedia di database sumber.
postalCode, timezone: Tidak diisi oleh database sumber saat ini — selalu null.

Kirim request sisi server

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Tetapkan WATCH_IP_SECRET_KEY di environment server Anda terlebih dahulu. 8.8.8.8 adalah contoh alamat yang valid secara sintaks; contoh ini tidak menjanjikan negara, kota, atau respons tertentu untuknya.

Pertanyaan yang sering diajukan

Bisakah saya menggunakan API ini untuk mencari alamat IP orang lain?

Endpoint ini menerima alamat IP yang dikirim dan mengembalikan data lokasi database yang tersedia, bukan nama, alamat lengkap, atau identitas seseorang. Gunakan hanya data yang berwenang Anda proses.

Apakah mendukung IPv6?

Endpoint ini memvalidasi input IPv4 dan IPv6. Alamat yang valid tetap bisa tidak memiliki record database atau beberapa field lokasi.

Apakah pencarian mencakup timezone, ASN, atau deteksi VPN?

Tidak. Respons pencarian saat ini tidak menyertakan ASN atau indikator keamanan, dan sumber database pihak ketiganya tidak mengisi field timezone atau kode pos. Tinjau geolokasi pengunjung secara terpisah jika model klien-terhubungnya cocok dengan aplikasi Anda.

Bisakah saya mengirim request dari JavaScript browser?

Tidak — jangan pernah mengekspos secret pencarian di kode browser. Lakukan panggilan pencarian dari backend Anda, dan gunakan endpoint visitor dengan publishable key untuk geolokasi browser langsung.

Apakah ini termasuk dalam visitor key gratis?

Tidak. Pencarian menggunakan secret key dan kelompok paket yang terpisah; paket visitor gratis tidak memberikan akses ke pencarian sisi server.

Apa arti found: false?

Pencarian tidak mengembalikan record yang cocok. Pada implementasi saat ini, ini juga bisa terjadi saat database tidak tersedia atau belum termuat, jadi tampilkan "Lokasi tidak tersedia" dan pisahkan hasil ini dari input tidak valid, kegagalan autentikasi, dan error rate limit.