Geolokasi IP, pemeriksaan email, dan sinyal risiko login dari satu API.
Temukan lokasi pengunjung situs dari browser, cari alamat IP dari backend Anda, tangkap domain sekali pakai dan salah ketik di email pendaftaran, serta tandai perjalanan mustahil saat login — semuanya dengan satu paket dan satu kuota permintaan bulanan. Kartu ini menampilkan pratinjau data edge dan pengayaan lokal dari permintaan halaman ini; ini bukan respons API.
request.cf216.73.216.231
- Koordinat
- 39.9612, -82.9988
- Zona waktu
- America/New_York
- Kode pos
- 43215
- Benua
- NA
- Jaringan
- Anthropic, PBC
- ASN
- AS16509
- Mata uang
- $ USD
- Kode telepon negara
- +1
- Matahari terbit / terbenam
- 7.49 / 18.42
- Perangkat
- —
- Keamanan
- Tidak tersedia — tidak diperiksa
Pilih API untuk kebutuhan Anda
Menemukan lokasi pengunjung di situs web Anda
Panggil API geolokasi pengunjung langsung dari browser dengan publishable key yang dibatasi pada allowed origin Anda. Gunakan data negara dan kota perkiraan, zona waktu, dan konteks regional yang tersedia untuk menyarankan pengalaman yang lebih relevan.
Jelajahi geolokasi pengunjung →Mencari IP dari backend Anda
Sudah punya alamat IP di aplikasi Anda? Kirim ke endpoint pencarian IP dari server Anda. Secret key mengautentikasi request, dan responsnya berisi field lokasi dari database geolokasi IP pihak ketiga.
Jelajahi API pencarian IP →Memproses daftar alamat IP
Kirim hingga 100 alamat IP dalam satu request batch dan terima daftar hasil pencarian yang berurutan untuk pelaporan, pengayaan, dan alur kerja backend lainnya. Penggunaan pencarian diukur per IP, bukan per request batch.
Jelajahi pencarian IP massal →Periksa alamat email saat pendaftaran
Periksa sintaks, domain sekali pakai yang dikenal, apakah domain memiliki server email, kemungkinan salah ketik dan alamat peran, lalu dapatkan putusan terima, tinjau, atau tolak beserta alasannya. Panggil dari formulir Anda dengan kunci publishable, atau periksa hingga 100 alamat per permintaan — atau daftar hingga 100.000 — dari backend atau dasbor.
Jelajahi pemeriksaan email →Beri skor pendaftaran baru dalam satu panggilan
POST /v1/signup/check menggabungkan pemeriksaan email dengan negara dan jaringan IP yang mendaftar, indikator VPN, Tor, dan pusat data sesuai paket, serta usia domain email, menjadi skor 0–100 dan putusan beserta alasannya. Skor adalah konteks untuk keputusan Anda, bukan bukti penyalahgunaan.
Lihat alur kerja pencegahan penyalahgunaan pendaftaran →Tandai perjalanan mustahil saat login
POST /v1/risk/check membandingkan perkiraan lokasi IP login dengan lokasi tersimpan sebelumnya milik pengguna dan mengembalikan jarak, waktu berlalu, kecepatan tersirat, dan tingkat risiko. Hasilnya bisa positif palsu dan tidak membuktikan pengambilalihan akun.
Jelajahi deteksi perjalanan mustahil →Contoh integrasi browser dan preview edge
Contoh ini menunjukkan cara memanggil GET /v1/geo dari browser. Contoh ini tidak dijalankan untuk menghasilkan preview ini. Lokasi berasal dari request halaman ini; pengayaan diturunkan secara lokal. Nilai yang hilang berarti tidak tersedia, dan pengecekan security tidak dijalankan.
Contoh request — tidak dijalankan
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Preview request halaman — bukan respons API
{
"ip": "216.73.216.231",
"country": "US",
"region": "Ohio",
"regionCode": "OH",
"city": "Columbus",
"postalCode": "43215",
"latitude": 39.96118,
"longitude": -82.99879,
"continent": "NA",
"timezone": "America/New_York",
"isEUCountry": false,
"asn": 16509,
"asOrganization": "Anthropic, PBC",
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"callingCode": "+1",
"compliance": {
"isGDPR": false,
"usPrivacyLaw": null,
"isLGPD": false,
"requiresCookieConsent": false,
"dataResidencyZone": "US",
"isEmbargoedCountry": false
},
"locale": {
"suggestedLocale": "en-US",
"measurementSystem": "imperial",
"firstDayOfWeek": 0,
"dateFormat": "MM/DD/YYYY"
},
"sun": {
"sunrise": "2026-10-23T11:49:40.834Z",
"sunset": "2026-10-23T22:42:44.749Z"
},
"holiday": {
"isPublicHolidayToday": false,
"todayHolidayName": null,
"nextHoliday": {
"date": "2026-11-11",
"name": "Veterans Day"
}
},
"age": {
"ageOfMajority": 18,
"drinkingAge": 21,
"adultContentVerificationRequired": true,
"jurisdictionNote": "HB 96 (2025)"
},
"tax": {
"jurisdictionCode": "US-OH",
"taxSystem": "US_SALES_TAX",
"rate": null
},
"userAgent": {
"browser": null,
"browserVersion": null,
"os": null,
"osVersion": null,
"deviceType": "bot"
}
}Geolokasi visitor dan backend
Gunakan GET /v1/geo di browser pengunjung dengan publishable key. Gunakan GET /v1/lookup/{ip} atau POST /v1/lookup di backend Anda dengan secret key untuk IP yang dikirim.
Satu paket untuk setiap pemeriksaan
Geolokasi, pencarian IP, serta pemeriksaan email, pendaftaran, dan perjalanan mustahil semuanya memakai kuota permintaan bulanan yang sama — satu permintaan per panggilan, per IP, atau per alamat yang diperiksa. Tidak ada produk terpisah yang perlu dibeli, dan setiap paket, termasuk Free, dapat menerbitkan kedua jenis kunci.
Pemeriksaan email tingkat domain
Pemeriksaan email melihat sintaks, status sekali pakai domain dan catatan server emailnya, kemungkinan salah ketik, dan alamat peran. Pemeriksaan ini tidak pernah menghubungi kotak surat, sehingga tidak ada hasil yang memastikan bahwa alamat ada atau dapat menerima email.
Key yang dikunci origin
API key Anda bersifat publishable, seperti key Stripe atau Google Maps. Request hanya dilayani — dan CORS hanya diberikan — untuk origin yang Anda daftarkan.
Geolokasi edge
GET /v1/geo membaca data lokasi tingkat jaringan untuk IP yang terhubung. Lokasi IP bersifat perkiraan; waktu respons tergantung request dan fitur yang diaktifkan.
Pengayaan regional
Respons visitor menurunkan mata uang, kode telepon negara, waktu matahari terbit/terbenam, dan petunjuk perangkat dari lokasi dan header request. Field bisa bernilai null saat data sumbernya tidak tersedia.
Petunjuk kepatuhan regional
Pemetaan negara dan wilayah yang statis memberikan petunjuk kepatuhan. Ini tidak menetapkan kewajiban hukum atau menjamin kepatuhan.
Negosiasi locale, sudah diselesaikan untuk Anda
Setiap respons menyertakan objek locale: locale BCP47 yang paling cocok (menggabungkan negara pengunjung dengan header Accept-Language browser mereka, sehingga pengunjung berbahasa Prancis di Kanada mendapat fr-CA, bukan fr-FR), ditambah sistem pengukuran, hari pertama minggu, dan format tanggal — lewati implementasi ulang hal ini di lapisan i18n Anda sendiri.
Kalender hari libur nasional
Setiap respons menyertakan objek holiday: apakah hari ini hari libur nasional di negara pengunjung, namanya, dan hari libur berikutnya — berguna untuk salinan widget dukungan "kami tutup hari ini," pesan checkout, atau logika penjadwalan, mencakup daftar terkurasi sekitar 40 negara.
Petunjuk yurisdiksi usia
Pemetaan statis memberikan petunjuk usia dan yurisdiksi berdasarkan perkiraan lokasi IP. Ini tidak memverifikasi identitas atau usia; konfirmasikan persyaratan yang berlaku secara independen.
Petunjuk yurisdiksi pajak
Pemetaan statis memberikan konteks pajak regional. Ini bukan perhitungan pajak atau pengganti mesin pajak yang terkelola.
Paket source SDK
Repositori mencakup klien JavaScript/TypeScript, Python, PHP, Go, dan Flutter/Dart. Dukungan endpoint bervariasi; lihat dokumentasi dan pastikan ketersediaan paket sebelum instalasi.
Sinyal VPN, Tor & jaringan
Paket visitor yang memenuhi syarat menyertakan indikator VPN, Tor, pusat data, ancaman, dan jaringan yang terkena sanksi berbasis daftar. Flag yang bernilai false berarti tidak ada kecocokan dalam data yang tersedia, bukan pengunjung yang aman. Cakupan IPv6 bersifat sebagian; Tor IPv6 tidak dicakup.
Subdomain bermerek
Paket Growth dan Scale menyertakan jalur pengaturan domain kustom di dashboard. Ketersediaan tergantung kelayakan akun serta keberhasilan pengaturan DNS dan SSL; integrasi harus menggunakan base URL yang telah dikonfigurasi.
Sinyal perjalanan mustahil
POST /v1/risk/check membandingkan lokasi perkiraan sebuah IP yang dikirim dengan baseline pengguna yang tersimpan. Ini bisa menghasilkan positif palsu dan tidak membuktikan akun diretas. Hubungi kami untuk mengonfirmasi ketersediaan dan penyediaan (provisioning).
Pahami responsnya sebelum Anda berintegrasi
API visitor dan pencarian melayani request yang berbeda dan mengembalikan data yang berbeda pula. Visitor geo menggunakan geolokasi edge dari request yang terhubung dan menambahkan konteks regional. Pencarian IP menyelesaikan alamat yang Anda kirim menggunakan database geolokasi IP pihak ketiga. Respons pencarian tidak berisi semua pengayaan yang tersedia di visitor geo — misalnya, kode pos dan zona waktu tidak disediakan oleh dataset ini saat ini. Pemeriksaan email, pendaftaran, dan risiko masing-masing memproses input yang Anda kirim — sebuah alamat, atau ID pengguna dan IP — dan setiap baris di bawah memakai kuota permintaan bulanan yang sama.
| Kebutuhan Anda | Endpoint | Key | Fokus data |
|---|---|---|---|
| Menemukan pengunjung situs web yang terhubung | GET /v1/geo | Publishable, dibatasi origin | Lokasi pengunjung dan konteks regional |
| Mencari satu IP yang dikirim | GET /v1/lookup/{ip} | Secret Bearer key | Hasil lokasi database geolokasi IP pihak ketiga |
| Mencari beberapa IP yang dikirim | POST /v1/lookup | Secret Bearer key | Hingga 100 hasil lokasi berurutan |
| Periksa alamat email di formulir pendaftaran | POST /v1/email/validate | Publishable, dibatasi origin | Sinyal sintaks, domain sekali pakai, server email, dan salah ketik, dengan putusan |
| Periksa alamat email secara massal | POST /v1/email/batch, /v1/email/jobs | Secret Bearer key | Hingga 100 per permintaan, atau hingga 100.000 per tugas daftar asinkron |
| Beri skor pendaftaran baru | POST /v1/signup/check | Secret Bearer key | Skor 0–100 dari sinyal email, jaringan IP, dan usia domain |
| Bandingkan login dengan lokasi sebelumnya | POST /v1/risk/check | Secret Bearer key | Jarak, kecepatan tersirat, dan penanda perjalanan mustahil |
Pertanyaan yang sering diajukan
Bisakah Watch-IP mencari geolokasi alamat IP yang saya berikan?
Ya. Gunakan API pencarian IP sisi server dengan secret key. Endpoint visitor browser menemukan klien yang terhubung dan tidak menerima IP sembarang untuk dicari.
Bisakah saya menggunakan Watch-IP dari JavaScript di browser?
Gunakan visitor geo dengan publishable key yang dikonfigurasi untuk origin situs web Anda. Secret key pencarian harus berada di backend Anda dan tidak boleh pernah muncul di kode browser.
Apakah geolokasi IP sama dengan Geolocation API browser?
Tidak. Watch-IP memperkirakan lokasi dari koneksi IP. Geolocation API browser adalah mekanisme terpisah yang bisa meminta izin untuk lokasi yang disediakan perangkat.
Bisakah saya mencari alamat IPv4 dan IPv6?
Endpoint pencarian menerima alamat IPv4 dan IPv6 yang valid, tergantung ketersediaan record database. Cakupan sinyal keamanan adalah pertanyaan terpisah dan bervariasi menurut indikator dan versi IP.
Apakah Watch-IP memiliki paket gratis?
Ya. Paket Free mencakup kuota permintaan bulanan serta kuota pencarian IP yang lebih kecil; lihat halaman harga untuk batas terkini. Pemeriksaan email, pendaftaran, dan perjalanan mustahil memakai kuota yang sama, tanpa paket terpisah.
Apakah pemeriksaan email memverifikasi bahwa kotak surat ada?
Tidak. Watch-IP memeriksa sintaks, domain (daftar sekali pakai, catatan server email, usia), dan pola alamat seperti salah ketik dan akun peran. Watch-IP tidak menghubungi server email, sehingga tidak ada hasil yang memastikan bahwa kotak surat ada atau dapat menerima email.
Apakah pemeriksaan email dan risiko memerlukan paket terpisah?
Tidak. Setiap alamat yang diperiksa, pemeriksaan pendaftaran, atau pemeriksaan perjalanan mustahil dihitung sebagai satu permintaan dari kuota bulanan yang sama dengan panggilan geolokasi dan pencarian Anda. Endpoint backend menggunakan secret key yang diterbitkan dari dasbor Anda.
Apakah flag security yang bernilai false berarti pengunjungnya aman?
Tidak. Ini berarti pengecekan tidak menemukan kecocokan dalam data yang digunakannya. Cakupan yang belum lengkap, jaringan yang belum terdaftar, dan sinyal yang tidak tersedia harus dipertimbangkan secara terpisah.
Pilih integrasi pertama Anda
Mulailah dengan panduan pengunjung untuk situs web, halaman produk pencarian IP untuk aplikasi backend, atau pemeriksaan email untuk formulir pendaftaran Anda.