Geolocalizzazione IP, controlli email e segnali di rischio di accesso da un'unica API.
Localizza i visitatori del sito dal browser, cerca indirizzi IP dal tuo backend, individua domini usa e getta ed errori di battitura nelle email di registrazione e segnala i viaggi impossibili all'accesso — tutto con un solo piano e un'unica quota mensile di richieste. La scheda mostra un'anteprima dei dati edge e dell'arricchimento locale di questa richiesta di pagina; non è una risposta dell'API.
request.cf216.73.216.231
- Coordinate
- 39.9612, -82.9988
- Fuso orario
- America/New_York
- CAP
- 43215
- Continente
- NA
- Rete
- Anthropic, PBC
- ASN
- AS16509
- Valuta
- $ USD
- Prefisso internazionale
- +1
- Alba / tramonto
- 7:50 / 18:41
- Dispositivo
- —
- Sicurezza
- Non disponibile — non verificato
Scegli l'API adatta al tuo compito
Individua il visitatore sul tuo sito web
Chiama l'API di geolocalizzazione del visitatore direttamente dal browser con una chiave pubblicabile limitata alle tue origini consentite. Usa i dati approssimativi di paese e città, il fuso orario e il contesto regionale disponibile per suggerire un'esperienza più pertinente.
Scopri la geolocalizzazione del visitatore →Cerca un IP dal tuo backend
Hai già un indirizzo IP nella tua applicazione? Invialo all'endpoint di ricerca IP dal tuo server. Una chiave segreta autentica la richiesta e la risposta contiene i campi di localizzazione di un database di geolocalizzazione IP di terze parti.
Scopri l'API di ricerca IP →Elabora un elenco di indirizzi IP
Invia fino a 100 indirizzi IP in un'unica richiesta in blocco e ricevi un elenco ordinato di risultati di ricerca per reportistica, arricchimento e altri flussi di lavoro backend. L'utilizzo di ricerca viene misurato per IP, non per richiesta in blocco.
Scopri la ricerca IP in blocco →Controllare gli indirizzi email alla registrazione
Controlla 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 ottieni un verdetto accetta, rivedi o rifiuta con le motivazioni. Chiamala dal tuo modulo con una chiave pubblicabile, oppure controlla fino a 100 indirizzi per richiesta — o liste fino a 100.000 — dal tuo backend o dalla dashboard.
Scopri i controlli email →Valutare una nuova registrazione con una sola chiamata
POST /v1/signup/check combina il controllo dell'email con il paese e la rete dell'IP che si registra, gli indicatori VPN, Tor e datacenter in base al piano e l'età del dominio email, in un punteggio da 0 a 100 e un verdetto motivato. Il punteggio è un contesto per la tua decisione, non una prova di abuso.
Vedi il flusso contro gli abusi in registrazione →Segnalare i viaggi impossibili all'accesso
POST /v1/risk/check confronta la posizione approssimativa dell'IP di accesso con la precedente posizione salvata dell'utente e restituisce distanza, tempo trascorso, velocità implicita e un livello di rischio. Può produrre falsi positivi e non prova la compromissione di un account.
Scopri il rilevamento dei viaggi impossibili →Esempio di integrazione da browser e anteprima edge
L'esempio mostra come chiamare GET /v1/geo da un browser. Non è stato eseguito per produrre questa anteprima. La posizione proviene da questa richiesta di pagina; l'arricchimento è derivato localmente. I valori mancanti sono non disponibili e i controlli di sicurezza non vengono eseguiti.
Esempio di richiesta — non eseguita
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Anteprima della richiesta di pagina — non è una risposta 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-24T11:50:47.991Z",
"sunset": "2026-10-24T22:41:23.414Z"
},
"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"
}
}Geolocalizzazione del visitatore e del backend
Usa GET /v1/geo nel browser del visitatore con una chiave pubblicabile. Usa GET /v1/lookup/{ip} o POST /v1/lookup sul tuo backend con una chiave segreta per gli IP forniti.
Un solo piano per ogni controllo
Geolocalizzazione, ricerca IP e controlli di email, registrazione e viaggio impossibile attingono tutti alla stessa quota mensile di richieste — una richiesta per chiamata, per IP o per indirizzo controllato. Nessun prodotto separato da acquistare, e ogni piano, incluso Free, può emettere entrambi i tipi di chiave.
Controlli email a livello di dominio
I controlli email esaminano la sintassi, lo stato usa e getta del dominio e i suoi record del server di posta, i probabili errori di battitura e gli indirizzi generici. Non contattano mai la casella di posta, quindi nessun risultato conferma che un indirizzo esista o possa ricevere email.
Chiavi vincolate all'origine
La tua chiave API è pubblicabile, come una chiave Stripe o Google Maps. Le richieste vengono servite — e il CORS concesso — solo per le origini che registri.
Geolocalizzazione edge
GET /v1/geo legge i dati di localizzazione a livello di rete per l'IP in connessione. La posizione IP è approssimativa; il tempo di risposta dipende dalla richiesta e dalle funzionalità abilitate.
Arricchimento regionale
Le risposte per il visitatore derivano valuta, prefisso internazionale, orari di alba/tramonto e indicazioni sul dispositivo dalla posizione e dagli header della richiesta. I campi possono essere null quando i dati di origine non sono disponibili.
Indicazioni di conformità regionale
Le mappature statiche di paese e regione forniscono indicazioni di conformità. Non stabiliscono obblighi legali né garantiscono la conformità.
Determinazione della locale, già pronta
Ogni risposta include un oggetto locale: la locale BCP47 più adatta (combinando il paese del visitatore con l'header Accept-Language del suo browser, così un visitatore francofono in Canada ottiene fr-CA, non fr-FR), oltre a sistema di misura, primo giorno della settimana e formato data — eviti di reimplementarlo nel tuo livello di i18n.
Calendario delle festività pubbliche
Ogni risposta include un oggetto holiday: se oggi è una festività pubblica nel paese del visitatore, il suo nome e la prossima in arrivo — utile per messaggi del tipo "oggi siamo chiusi" nel widget di assistenza, per la messaggistica di checkout o per la logica di pianificazione, con una lista curata di circa 40 paesi.
Indicazioni sulla giurisdizione anagrafica
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.
Indicazioni sulla giurisdizione fiscale
Le mappature statiche forniscono un contesto fiscale regionale. Non costituiscono un calcolo fiscale né sostituiscono un motore fiscale mantenuto attivamente.
Pacchetti SDK sorgente
Il repository include client per JavaScript/TypeScript, Python, PHP, Go e Flutter/Dart. Il supporto degli endpoint varia; consulta la documentazione e verifica la disponibilità del pacchetto prima dell'installazione.
Segnali VPN, Tor e di rete
I piani visitatore idonei includono indicatori basati su liste per VPN, Tor, datacenter, minacce e reti sanzionate. Un falso segnale significa nessuna corrispondenza nei dati disponibili, non un visitatore sicuro. La copertura IPv6 è parziale; Tor su IPv6 non è coperto.
Sottodomini personalizzati
I piani Growth e Scale includono un percorso di configurazione del dominio personalizzato nella dashboard. La disponibilità dipende dall'idoneità dell'account e dal completamento della configurazione DNS e SSL; le integrazioni devono usare l'URL base configurato.
Segnale di spostamento impossibile
POST /v1/risk/check confronta la posizione approssimativa di un IP fornito con una baseline utente memorizzata. Può produrre falsi positivi e non dimostra la compromissione di un account. Contattaci per verificare disponibilità e provisioning.
Comprendi la risposta prima di integrare
Le API di visitatore e ricerca gestiscono richieste diverse e restituiscono dati diversi. La geolocalizzazione del visitatore usa i dati edge della richiesta in arrivo e aggiunge contesto regionale. La ricerca IP risolve l'indirizzo che fornisci usando un database di geolocalizzazione IP di terze parti. Le risposte di ricerca non contengono tutto l'arricchimento disponibile nella geolocalizzazione del visitatore: ad esempio, il CAP e il fuso orario non sono forniti dall'attuale dataset di origine. I controlli di email, registrazione e rischio lavorano ciascuno sui dati che invii — un indirizzo, oppure un ID utente e un IP — e ogni riga qui sotto attinge alla stessa quota mensile di richieste.
| Il tuo compito | Endpoint | Chiave | Focus sui dati |
|---|---|---|---|
| Individua il visitatore del sito web in connessione | GET /v1/geo | Pubblicabile, con restrizione di origine | Posizione del visitatore e contesto regionale |
| Cerca un IP fornito | GET /v1/lookup/{ip} | Chiave segreta Bearer | Risultato di localizzazione da database di terze parti |
| Cerca più indirizzi IP forniti | POST /v1/lookup | Chiave segreta Bearer | Fino a 100 risultati di localizzazione ordinati |
| Controllare un indirizzo email in un modulo di registrazione | POST /v1/email/validate | Pubblicabile, con restrizione di origine | Segnali di sintassi, dominio usa e getta, server di posta ed errori di battitura, con un verdetto |
| Controllare indirizzi email in blocco | POST /v1/email/batch, /v1/email/jobs | Chiave segreta Bearer | Fino a 100 per richiesta, o fino a 100.000 per job di lista asincrono |
| Valutare una nuova registrazione | POST /v1/signup/check | Chiave segreta Bearer | Punteggio da 0 a 100 da segnali email, di rete IP e di età del dominio |
| Confrontare un accesso con la posizione precedente | POST /v1/risk/check | Chiave segreta Bearer | Distanza, velocità implicita e indicatore di viaggio impossibile |
Domande frequenti
Watch-IP può geolocalizzare un indirizzo IP che fornisco io?
Sì. Usa l'API di ricerca IP lato server con una chiave segreta. L'endpoint di visitatore del browser individua il client in connessione e non accetta un IP arbitrario da cercare.
Posso usare Watch-IP da JavaScript in un browser?
Usa la geolocalizzazione del visitatore con una chiave pubblicabile configurata per l'origine del tuo sito web. Le chiavi segrete di ricerca devono restare sul tuo backend e non devono mai comparire nel codice del browser.
La geolocalizzazione IP è la stessa cosa dell'API Geolocation del browser?
No. Watch-IP stima la posizione a partire da una connessione IP. L'API Geolocation del browser è un meccanismo separato che può richiedere il permesso per la posizione fornita dal dispositivo.
Posso cercare indirizzi IPv4 e IPv6?
Gli endpoint di ricerca accettano indirizzi IPv4 e IPv6 validi, in base ai record disponibili nel database. La copertura dei segnali di sicurezza è una questione separata e varia in base all'indicatore e alla versione IP.
Watch-IP ha un piano gratuito?
Sì. Il piano Free include una quota mensile di richieste e una quota minore di ricerche IP; consulta la pagina dei prezzi per i limiti attuali. I controlli di email, registrazione e viaggio impossibile attingono alla stessa quota, senza un piano separato.
Il controllo email verifica che una casella di posta esista?
No. Watch-IP controlla la sintassi, il dominio (liste di domini usa e getta, record del server di posta, età) e schemi dell'indirizzo come errori di battitura e account generici. Non contatta il server di posta, quindi nessun risultato conferma che una casella esista o possa ricevere email.
I controlli email e di rischio richiedono un piano separato?
No. Ogni indirizzo controllato, controllo di registrazione o di viaggio impossibile conta come una richiesta sulla stessa quota mensile delle tue chiamate di geolocalizzazione e ricerca. Gli endpoint backend usano una chiave segreta emessa dalla dashboard.
Un falso segnale di sicurezza significa che il visitatore è sicuro?
No. Significa che il controllo non ha trovato una corrispondenza nei dati che utilizza. Copertura mancante, reti non elencate e segnali non disponibili vanno considerati separatamente.
Scegli la tua prima integrazione
Inizia dalla guida ai visitatori per un sito web, dalla pagina del prodotto di ricerca IP per un'applicazione backend, o dal controllo email per il tuo modulo di registrazione.