Scegli un piano per l'API di cui hai bisogno

Ogni chiamata autenticata che supera i controlli di chiave e origine conta come una richiesta: una chiamata di geolocalizzazione visitatore, ogni IP cercato, ogni indirizzo email controllato, ogni controllo di registrazione e ogni controllo di viaggio impossibile. Una chiamata che poi non supera la validazione dell'input conta comunque. Le chiamate rifiutate per chiave mancante o non valida, origine non consentita o limite di frequenza al minuto non contano, così come l'eliminazione di una baseline di rischio o l'interrogazione dello stato di un job di lista email.

È una finestra fissa di un minuto, allineata al minuto dell'orologio — non una media mobile. Con il piano Free puoi effettuare fino a 30 richieste, ad esempio, tra le 10:32:00 e le 10:32:59; il contatore si azzera alle 10:33:00. Superarlo restituisce un HTTP 429 con un header Retry-After che indica quanti secondi mancano al reset della finestra. È indipendente dal tuo volume mensile di richieste qui sotto — limita la frequenza di picco, non l'utilizzo totale. Il limite conta le chiamate API, non gli elementi: un batch fino a 100 IP o indirizzi email, o la creazione di un job di lista email, conta come una sola richiesta — mentre ogni IP o indirizzo al suo interno continua a contare separatamente nel tuo volume mensile di richieste.

Non disattiviamo automaticamente la tua chiave. Se ti trovi costantemente vicino al limite del tuo piano, esegui l'upgrade in qualsiasi momento dalla tua dashboard — senza bisogno di modificare codice o chiavi API.

La geolocalizzazione del visitatore legge i dati della richiesta all'edge e deriva l'arricchimento regionale localmente, il che mantiene il suo costo — e il suo prezzo — ben al di sotto dei livelli equivalenti della maggior parte dei fornitori. La ricerca IP lato server è inclusa nello stesso piano e prezzo invece di essere venduta separatamente: ogni piano include sia un limite di richieste sia un plafond di ricerche IP, entrambi prelevati dal pool mensile condiviso di quel piano.

Le risposte di geolocalizzazione dei visitatori e di ricerca IP includono l'arricchimento regionale quando i dati di origine sono disponibili. I piani idonei includono anche indicatori di sicurezza basati su liste. I controlli email restituiscono un risultato separato, a livello di dominio. La latenza varia in base alla richiesta e alle funzionalità attive.

Sì. GET /v1/geo resta solo l'auto-ricerca del visitatore, lato client, che risolve l'IP effettivamente in connessione. Per la ricerca di un IP arbitrario, GET /v1/lookup/{ip} (singolo) e POST /v1/lookup (in batch, fino a 100 IP per chiamata) sono endpoint server-to-server autenticati con una chiave segreta invece della tua chiave pubblicabile — la chiave resta sul tuo backend e non viene mai inviata a un browser. Entrambi si basano su un database di geolocalizzazione IP di terze parti invece che sui nostri dati di rete in tempo reale, con una struttura di risposta diversa e senza una classificazione di accuratezza relativa verificata — consulta le fonti dati per il fornitore specifico e l'attribuzione richiesta — e l'utilizzo viene fatturato per IP ricercato, prelevato dal pool mensile condiviso del tuo piano uno a uno con una richiesta geo (vedi il plafond di ricerche IP del tuo piano sopra per il limite separato sul totale delle ricerche). Poiché questo endpoint ricerca IP forniti dal tuo cliente invece che dal visitatore che chiama di propria iniziativa, ciò rende Watch-IP un responsabile del trattamento di questi dati di terze parti per tuo conto — consulta il DPA per sapere cosa significa questo per i tuoi obblighi di conformità.

POST /v1/risk/check confronta la posizione risolta da terze parti di un IP fornito con una baseline utente memorizzata e restituisce un rischio basso/medio/alto e un flag impossibleTravel. Usa una chiave segreta Bearer lato backend. Contattaci per confermare disponibilità, provisioning e prezzi; l'applicazione indipendente del piano di rischio e la disponibilità del checkout non sono state verificate. I cambi di VPN e il routing mobile possono causare falsi positivi.

Sì. POST /v1/email/validate usa una chiave pubblicabile, vincolata all'origine, per controllare la sintassi, i domini usa e getta noti, se il dominio ha un server di posta, i probabili errori di battitura e gli indirizzi generici, e restituisce un verdetto accetta, rivedi o rifiuta con le motivazioni. Dal tuo backend, POST /v1/email/batch controlla fino a 100 indirizzi per chiamata, i job di lista ne gestiscono fino a 100.000, e POST /v1/signup/check aggiunge i segnali di rete dell'IP che si registra. Ogni indirizzo controllato conta come una richiesta sulla quota mensile del tuo piano (un job di lista addebita ogni indirizzo distinto una sola volta). Nessuno di questi controlli contatta la casella di posta, quindi non verificano esistenza, titolarità o recapitabilità di una casella.

Dipende dal tipo di chiave. Le chiavi pubblicabili — usate per GET /v1/geo e POST /v1/email/validate — sono pensate per stare nel codice sorgente della pagina, come una chiave pubblicabile di Stripe o Google Maps; il controllo di accesso è il vincolo di origine: ogni chiave funziona solo dai domini che registri, e CORS viene concesso solo a un'origine corrispondente. Le chiavi segrete — usate per ricerca IP, controllo email in blocco e controlli di registrazione e viaggio impossibile — devono restare sul tuo backend e non comparire mai nel codice del browser.

Esistono pacchetti SDK sorgente per JavaScript/TypeScript, Python, PHP, Go e Flutter/Dart. Verifica la disponibilità nel registry e il supporto degli endpoint prima dell'uso. GET /v1/geo individua sempre il chiamante in connessione; una chiamata dal backend non individua il visitatore del tuo sito web. Usa la ricerca con chiave segreta per un IP fornito.

Sì, ma è opzionale: aggiungi ?include=hostname alla richiesta (oppure include: ["hostname"] nell'SDK) e la risposta acquisisce un campo hostname, risolto tramite una ricerca PTR DNS-over-HTTPS. È null quando non esiste un record PTR. A differenza dei campi di arricchimento sempre attivi sopra descritti, questa operazione esegue una vera ricerca di rete all'interno della richiesta, quindi è disattivata per impostazione predefinita anziché aggiungere latenza a ogni chiamata.

I piani idonei includono gli indicatori basati su liste isVpn, isTor, isDatacenter, isThreat e isSanctionedNetwork sia nelle risposte di geolocalizzazione dei visitatori sia in quelle di ricerca IP; Free omette la sicurezza. IPv4 supporta la corrispondenza per liste e per ASN. IPv6 supporta intervalli VPN, datacenter e minacce più la corrispondenza per ASN, ma non ha copertura Tor. La copertura in produzione dipende dai feed disponibili. False significa nessuna corrispondenza nei dati disponibili, non una garanzia di sicurezza; questi segnali non sono uno screening definitivo delle sanzioni.

Sì — ogni risposta include un oggetto compliance: isGDPR (UE/SEE + Regno Unito), usPrivacyLaw (la normativa statale statunitense applicabile, ad es. CCPA/CPRA o VCDPA, in base allo stato del visitatore), isLGPD (Brasile), un flag requiresCookieConsent derivato, una dataResidencyZone approssimativa e isEmbargoedCountry (embarghi Paese comprensivi OFAC). È incluso senza costi aggiuntivi in ogni piano, come valuta e prefisso internazionale. È un segnale di giurisdizione di primo livello calcolato dalla posizione del visitatore, non una consulenza legale — verifica sempre i requisiti di conformità con i tuoi consulenti legali.

Sì — ogni risposta include un oggetto locale: suggestedLocale è una locale BCP47 che combina il paese del visitatore con l'header Accept-Language del suo browser, privilegiando una lingua effettivamente parlata lì (ad esempio, un Accept-Language "fr" da un visitatore canadese produce "fr-CA", non "fr-FR"), ricadendo sulla locale predefinita del paese quando nulla nell'header corrisponde. Lo stesso oggetto include anche measurementSystem (metrico/imperiale), firstDayOfWeek e dateFormat, così non devi ricavare tu stesso le convenzioni di formattazione regionali. È incluso senza costi aggiuntivi in ogni piano.

Sì — ogni risposta include un oggetto holiday: isPublicHolidayToday, todayHolidayName e nextHoliday (data e nome) per il paese del visitatore, calcolati da una tabella statica curata (attualmente circa 40 paesi — G20 + UE/SEE + Regno Unito) proveniente da Nager.Date e aggiornata con una cadenza manuale una o due volte l'anno anziché con un calcolo al momento della richiesta. È null per i paesi fuori da questo elenco e considera solo le festività pubbliche nazionali, non le festività limitate a stato/provincia. Incluso senza costi aggiuntivi in ogni piano; altri paesi possono essere aggiunti su richiesta.

Le mappature statiche forniscono indicazioni su età e giurisdizione in base alla posizione IP approssimativa. Non verificano l'identità né l'età; verifica autonomamente i requisiti applicabili.