Pilih paket untuk API yang Anda butuhkan

Setiap panggilan terautentikasi yang lolos pemeriksaan kunci dan origin dihitung sebagai satu permintaan: panggilan geolokasi pengunjung, setiap IP yang dicari, setiap alamat email yang diperiksa, setiap pemeriksaan pendaftaran, dan setiap pemeriksaan perjalanan mustahil. Panggilan yang kemudian gagal validasi input tetap dihitung. Panggilan yang ditolak karena kunci tidak ada atau tidak valid, origin yang tidak diizinkan, atau batas laju per menit tidak dihitung, begitu pula menghapus baseline risiko atau memeriksa status tugas daftar email.

Ini adalah jendela tetap satu menit, selaras dengan menit jam — bukan rata-rata bergulir. Pada paket Free, Anda bisa melakukan hingga 30 request antara, katakanlah, 10:32:00 dan 10:32:59; penghitung kembali ke nol pada 10:33:00. Melebihi batas ini mengembalikan HTTP 429 dengan header Retry-After yang memberi tahu berapa detik lagi sampai jendelanya reset. Ini terpisah dari volume request bulanan Anda di bawah — ini membatasi tingkat burst, bukan total penggunaan. Batas ini menghitung panggilan API, bukan item: satu batch berisi hingga 100 IP atau alamat email, atau pembuatan list job email, dihitung sebagai satu request — sementara setiap IP atau alamat di dalamnya tetap dihitung terpisah terhadap volume request bulanan Anda.

Kami tidak memutus key Anda secara otomatis. Jika Anda secara konsisten mendekati batas paket Anda, tingkatkan kapan saja dari dashboard Anda — tidak perlu perubahan kode atau API key.

Geolokasi pengunjung membaca data request di edge dan menghasilkan pengayaan regional secara lokal, sehingga biayanya — dan harganya — tetap jauh di bawah tingkatan setara dari kebanyakan penyedia lain. Pencarian IP sisi server digabungkan ke dalam paket dan harga yang sama, bukan dijual terpisah: setiap paket menyertakan batas request maupun kuota pencarian IP, keduanya diambil dari pool bulanan bersama milik paket tersebut.

Respons geolokasi pengunjung dan pencarian IP menyertakan pengayaan regional bila data sumber tersedia. Paket yang memenuhi syarat juga menyertakan indikator keamanan berbasis daftar. Pemeriksaan email mengembalikan hasil terpisah di tingkat domain. Latensi bervariasi menurut permintaan dan fitur yang diaktifkan.

Ya. GET /v1/geo tetap hanya untuk pencarian mandiri pengunjung di sisi klien, yang menyelesaikan IP yang benar-benar terhubung. Untuk pencarian IP sembarang, GET /v1/lookup/{ip} (tunggal) dan POST /v1/lookup (batch, hingga 100 IP per panggilan) adalah endpoint server-ke-server yang diautentikasi dengan kunci rahasia, bukan kunci yang bisa dipublikasikan — kunci tetap berada di backend Anda dan tidak pernah dikirim ke browser. Keduanya mengandalkan basis data geolokasi IP pihak ketiga, bukan data jaringan real-time milik kami sendiri, dengan bentuk respons yang berbeda dan tanpa peringkat akurasi relatif yang terverifikasi — lihat sumber data untuk penyedia spesifik dan atribusi yang diperlukan — dan penggunaan dikenakan biaya per IP yang dicari, diambil dari pool bulanan bersama paket Anda satu-lawan-satu dengan request geo (lihat kuota pencarian IP paket Anda di atas untuk batas terpisah pada total pencarian). Karena endpoint ini mencari IP yang disediakan oleh pelanggan Anda, bukan pengunjung yang memanggil atas kemauannya sendiri, ini membuat Watch-IP menjadi pemroses data pihak ketiga tersebut atas nama Anda — lihat DPA untuk mengetahui apa artinya ini bagi kewajiban kepatuhan Anda sendiri.

POST /v1/risk/check membandingkan lokasi hasil resolusi pihak ketiga dari sebuah IP yang dikirim dengan baseline pengguna tersimpan dan mengembalikan risiko low/medium/high serta flag impossibleTravel. Ini menggunakan secret Bearer key backend. Hubungi kami untuk mengonfirmasi ketersediaan, penyediaan, dan harga; penerapan paket risiko independen dan kesiapan checkout belum diverifikasi. Perubahan VPN dan perutean seluler bisa menyebabkan positif palsu.

Ya. POST /v1/email/validate menggunakan kunci publishable yang dibatasi origin untuk memeriksa sintaks, domain sekali pakai yang dikenal, apakah domain memiliki server email, kemungkinan salah ketik, dan alamat peran, lalu mengembalikan putusan terima, tinjau, atau tolak beserta alasannya. Dari backend Anda, POST /v1/email/batch memeriksa hingga 100 alamat per panggilan, tugas daftar menangani hingga 100.000, dan POST /v1/signup/check menambahkan sinyal jaringan IP yang mendaftar. Setiap alamat yang diperiksa dihitung sebagai satu permintaan dari kuota bulanan paket Anda (tugas daftar menagih setiap alamat unik satu kali). Tidak satu pun dari pemeriksaan ini menghubungi kotak surat, sehingga tidak memverifikasi keberadaan, kepemilikan, atau keterkiriman kotak surat.

Tergantung jenis kuncinya. Kunci publishable — untuk GET /v1/geo dan POST /v1/email/validate — memang dirancang untuk berada di kode sumber halaman, seperti kunci publishable Stripe atau Google Maps; kontrol aksesnya adalah penguncian origin: setiap kunci hanya berfungsi dari domain yang Anda daftarkan, dan CORS hanya diberikan ke origin yang cocok. Secret key — untuk pencarian IP, pemeriksaan email massal, serta pemeriksaan pendaftaran dan perjalanan mustahil — harus tetap di backend Anda dan tidak boleh muncul di kode browser.

Paket source SDK tersedia untuk JavaScript/TypeScript, Python, PHP, Go, dan Flutter/Dart. Pastikan ketersediaan registry dan dukungan endpoint sebelum digunakan. GET /v1/geo selalu menemukan pemanggil yang terhubung; panggilan backend tidak menemukan pengunjung situs web Anda. Gunakan pencarian secret-key untuk IP yang dikirim.

Bisa, tapi ini bersifat opt-in: tambahkan ?include=hostname ke request (atau include: ["hostname"] di SDK) dan respons akan mendapat field hostname, diselesaikan melalui pencarian PTR DNS-over-HTTPS. Nilainya null saat tidak ada record PTR. Berbeda dari field pengayaan yang selalu aktif di atas, ini melakukan pencarian jaringan sungguhan di dalam request, jadi secara default dimatikan alih-alih menambah latensi ke setiap panggilan.

Paket yang memenuhi syarat menyertakan flag berbasis daftar isVpn, isTor, isDatacenter, isThreat, dan isSanctionedNetwork pada respons geolokasi pengunjung maupun pencarian IP; Free tidak menyertakan keamanan. IPv4 mendukung pencocokan daftar dan ASN. IPv6 mendukung rentang VPN, pusat data, dan ancaman serta pencocokan ASN, tetapi tidak memiliki cakupan Tor. Cakupan di produksi bergantung pada feed yang tersedia. False berarti tidak ada kecocokan dalam data yang tersedia, bukan jaminan keamanan; sinyal ini bukan penyaringan sanksi yang definitif.

Ya — setiap respons menyertakan objek compliance: isGDPR (UE/EEA + Inggris), usPrivacyLaw (hukum negara bagian AS yang berlaku, misalnya CCPA/CPRA atau VCDPA, berdasarkan negara bagian pengunjung), isLGPD (Brasil), flag requiresCookieConsent yang diturunkan, dataResidencyZone yang kasar, dan isEmbargoedCountry (embargo negara komprehensif OFAC). Ini disertakan tanpa biaya tambahan di setiap paket, sama seperti mata uang dan kode telepon negara. Ini adalah sinyal yurisdiksi awal yang dihitung dari lokasi pengunjung, bukan nasihat hukum — selalu konfirmasikan persyaratan kepatuhan dengan penasihat hukum Anda sendiri.

Ya — setiap respons menyertakan objek locale: suggestedLocale adalah locale BCP47 yang menggabungkan negara pengunjung dengan header Accept-Language browser mereka, mengutamakan bahasa yang benar-benar dipakai di sana (misalnya, Accept-Language "fr" dari pengunjung Kanada menghasilkan "fr-CA", bukan "fr-FR"), kembali ke locale default negara tersebut saat tidak ada yang cocok di header. Objek yang sama juga menyertakan measurementSystem (metrik/imperial), firstDayOfWeek, dan dateFormat, jadi Anda tidak perlu menghitung ulang konvensi pemformatan regional sendiri. Ini disertakan tanpa biaya tambahan di setiap paket.

Ya — setiap respons menyertakan objek holiday: isPublicHolidayToday, todayHolidayName, dan nextHoliday (tanggal dan nama) untuk negara pengunjung, dihitung dari tabel statis terkurasi (saat ini ~40 negara — G20 + UE/EEA + Inggris) yang bersumber dari Nager.Date dan diperbarui secara manual satu atau dua kali setahun, bukan dihitung saat request. Nilainya null untuk negara di luar daftar tersebut, dan hanya menghitung hari libur nasional, bukan hari libur khusus negara bagian/provinsi. Disertakan tanpa biaya tambahan di setiap paket; lebih banyak negara bisa ditambahkan atas permintaan.

Pemetaan statis memberikan petunjuk usia dan yurisdiksi berdasarkan perkiraan lokasi IP. Ini tidak memverifikasi identitas atau usia; konfirmasikan persyaratan yang berlaku secara independen.