Géolocalisation IP, contrôle des e-mails et signaux de risque de connexion, dans une seule API.
Localisez les visiteurs de votre site depuis le navigateur, recherchez des adresses IP depuis votre backend, repérez les domaines jetables et les fautes de frappe dans les e-mails d'inscription, et signalez les voyages impossibles à la connexion — le tout avec un seul forfait et un seul quota mensuel de requêtes. La carte présente un aperçu des données edge et de l'enrichissement local de cette requête de page ; ce n'est pas une réponse de l'API.
request.cf216.73.216.205
- Coordonnées
- 39.9612, -82.9988
- Fuseau horaire
- America/New_York
- Code postal
- 43215
- Continent
- NA
- Réseau
- Anthropic, PBC
- ASN
- AS16509
- Devise
- $ USD
- Indicatif téléphonique
- +1
- Lever / coucher du soleil
- 7:48 / 18:44
- Appareil
- —
- Sécurité
- Indisponible — non vérifié
Choisissez l'API adaptée à votre besoin
Localiser le visiteur sur votre site
Appelez l'API de géolocalisation du visiteur directement depuis le navigateur avec une clé publiable restreinte à vos origines autorisées. Utilisez le pays et la ville approximatifs, le fuseau horaire et le contexte régional disponible pour proposer une expérience plus pertinente.
Découvrir la géolocalisation du visiteur →Rechercher une IP depuis votre backend
Vous avez déjà une adresse IP dans votre application ? Envoyez-la au point de terminaison de recherche d'IP depuis votre serveur. Une clé secrète authentifie la requête, et la réponse contient des champs de localisation issus d'une base de données tierce de géolocalisation IP.
Découvrir l'API de recherche d'IP →Traiter une liste d'adresses IP
Envoyez jusqu'à 100 adresses IP en une seule requête groupée et recevez une liste ordonnée de résultats de recherche pour vos rapports, votre enrichissement de données et d'autres workflows backend. L'usage de recherche est mesuré par IP, pas par requête groupée.
Découvrir la recherche d'IP groupée →Contrôler les adresses e-mail à l'inscription
Contrôlez la syntaxe, les domaines jetables connus, la présence d'un serveur de messagerie pour le domaine, les fautes de frappe probables et les adresses génériques, et obtenez un verdict accepter, examiner ou rejeter avec ses raisons. Appelez-la depuis votre formulaire avec une clé publiable, ou contrôlez jusqu'à 100 adresses par requête — ou des listes jusqu'à 100 000 — depuis votre backend ou le tableau de bord.
Découvrir le contrôle des e-mails →Évaluer une inscription en un seul appel
POST /v1/signup/check combine le contrôle de l'e-mail avec le pays et le réseau de l'IP qui s'inscrit, les indicateurs VPN, Tor et datacenter selon le forfait, ainsi que l'ancienneté du domaine de l'e-mail, en un score de 0 à 100 et un verdict motivé. Le score éclaire votre décision ; il ne prouve pas un abus.
Voir le parcours anti-abus à l'inscription →Signaler les voyages impossibles à la connexion
POST /v1/risk/check compare la localisation approximative de l'IP de connexion avec la précédente localisation enregistrée de l'utilisateur et renvoie la distance, le temps écoulé, la vitesse implicite et un niveau de risque. Il peut produire des faux positifs et ne prouve pas une prise de contrôle de compte.
Découvrir la détection de voyages impossibles →Exemple d'intégration navigateur et aperçu de périphérie
L'exemple montre comment appeler GET /v1/geo depuis un navigateur. Il n'a pas été exécuté pour produire cet aperçu. La localisation provient de cette requête de page ; l'enrichissement est dérivé localement. Les valeurs manquantes sont indisponibles, et les vérifications de sécurité ne sont pas exécutées.
Exemple de requête — non exécutée
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Aperçu de la requête de page — pas une réponse d'API
{
"ip": "216.73.216.205",
"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-22T11:48:34.072Z",
"sunset": "2026-10-22T22:44:07.184Z"
},
"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"
}
}Géolocalisation visiteur et backend
Utilisez GET /v1/geo dans le navigateur du visiteur avec une clé publiable. Utilisez GET /v1/lookup/{ip} ou POST /v1/lookup sur votre backend avec une clé secrète pour des IP fournies.
Un seul forfait pour tous les contrôles
Géolocalisation, recherche IP, contrôles d'e-mail, d'inscription et de voyage impossible puisent tous dans le même quota mensuel — une requête par appel, par IP ou par adresse contrôlée. Aucun produit séparé à acheter, et chaque forfait, y compris Free, peut émettre les deux types de clé.
Contrôles d'e-mail au niveau du domaine
Les contrôles d'e-mail portent sur la syntaxe, le caractère jetable du domaine et ses enregistrements de serveur de messagerie, les fautes de frappe probables et les adresses génériques. Ils ne contactent jamais la boîte aux lettres : aucun résultat ne confirme qu'une adresse existe ou peut recevoir du courrier.
Clés restreintes par origine
Votre clé API est publiable, comme une clé Stripe ou Google Maps. Les requêtes ne sont servies — et le CORS accordé — qu'aux origines que vous enregistrez.
Géolocalisation de périphérie
GET /v1/geo lit des données de localisation réseau pour l'IP connectée. La localisation IP est approximative ; le temps de réponse dépend de la requête et des fonctionnalités activées.
Enrichissement régional
Les réponses visiteur dérivent la devise, l'indicatif téléphonique, les heures de lever/coucher du soleil et des indices sur l'appareil à partir de la localisation et des en-têtes de requête. Les champs peuvent être vides (null) si la donnée source est indisponible.
Indications de conformité régionale
Des correspondances statiques par pays et région fournissent des indications de conformité. Elles n'établissent pas d'obligations légales et ne garantissent pas la conformité.
Négociation de paramètres régionaux, faite pour vous
Chaque réponse inclut un objet locale : le meilleur paramètre régional BCP47 (combinant le pays du visiteur avec l'en-tête Accept-Language de son navigateur, de sorte qu'un visiteur francophone au Canada obtient fr-CA, pas fr-FR), ainsi que le système de mesure, le premier jour de la semaine et le format de date — évitez de réimplémenter cela dans votre propre couche i18n.
Calendrier des jours fériés
Chaque réponse inclut un objet holiday : si aujourd'hui est un jour férié dans le pays du visiteur, son nom, et le prochain à venir — utile pour un message « nous sommes fermés aujourd'hui » sur un widget d'assistance, un message de commande, ou une logique de planification, couvrant une liste organisée d'environ 40 pays.
Indications de tranche d'âge
Des correspondances statiques fournissent des indications d'âge et de juridiction basées sur la localisation IP approximative. Elles ne vérifient pas l'identité ni l'âge ; confirmez les exigences applicables de manière indépendante.
Indications de juridiction fiscale
Des correspondances statiques fournissent un contexte fiscal régional. Ce n'est pas un calcul de taxe ni un substitut à un moteur fiscal maintenu à jour.
Paquets SDK source
Le dépôt inclut des clients JavaScript/TypeScript, Python, PHP, Go et Flutter/Dart. La prise en charge des points de terminaison varie ; consultez la documentation et vérifiez la disponibilité du paquet avant l'installation.
VPN, Tor et signaux réseau
Les forfaits visiteur éligibles incluent des indicateurs basés sur des listes pour VPN, Tor, centre de données, menace et réseau sous sanctions. Un signal négatif signifie l'absence de correspondance dans les données disponibles, pas un visiteur sûr. La couverture IPv6 est partielle ; Tor sur IPv6 n'est pas couvert.
Sous-domaines personnalisés
Les forfaits Growth et Scale incluent un parcours de configuration de domaine personnalisé dans le tableau de bord. La disponibilité dépend de l'éligibilité du compte et du succès de la configuration DNS et SSL ; les intégrations doivent utiliser l'URL de base configurée.
Signal de déplacement impossible
POST /v1/risk/check compare la localisation approximative d'une IP fournie à une référence utilisateur stockée. Ce signal peut produire des faux positifs et ne prouve pas une prise de contrôle de compte. Contactez-nous pour confirmer la disponibilité et la mise en service.
Comprendre la réponse avant d'intégrer
Les API de visiteur et de recherche répondent à des besoins différents et renvoient des données différentes. La géolocalisation du visiteur utilise les données de géolocalisation de périphérie de la requête entrante et ajoute du contexte régional. La recherche d'IP résout l'adresse que vous fournissez à l'aide d'une base de données tierce de géolocalisation IP. Les réponses de recherche ne contiennent pas tout l'enrichissement disponible dans la géolocalisation du visiteur — par exemple, le code postal et le fuseau horaire ne sont pas fournis par la source de données actuelle. Les contrôles d'e-mail, d'inscription et de risque portent chacun sur les données que vous envoyez — une adresse, ou un identifiant utilisateur et une IP — et chaque ligne ci-dessous puise dans le même quota mensuel de requêtes.
| Votre besoin | Point de terminaison | Clé | Focus des données |
|---|---|---|---|
| Localiser le visiteur connecté au site | GET /v1/geo | Publiable, restreinte par origine | Localisation du visiteur et contexte régional |
| Rechercher une IP fournie | GET /v1/lookup/{ip} | Clé secrète Bearer | Résultat de localisation d'une base de données tierce de géolocalisation IP |
| Rechercher plusieurs IP fournies | POST /v1/lookup | Clé secrète Bearer | Jusqu'à 100 résultats de localisation ordonnés |
| Contrôler une adresse e-mail dans un formulaire d'inscription | POST /v1/email/validate | Publiable, restreinte par origine | Signaux de syntaxe, de domaine jetable, de serveur de messagerie et de faute de frappe, avec un verdict |
| Contrôler des adresses e-mail en masse | POST /v1/email/batch, /v1/email/jobs | Clé secrète Bearer | Jusqu'à 100 par requête, ou jusqu'à 100 000 par tâche de liste asynchrone |
| Évaluer une nouvelle inscription | POST /v1/signup/check | Clé secrète Bearer | Score de 0 à 100 à partir de signaux e-mail, réseau IP et ancienneté du domaine |
| Comparer une connexion avec la localisation précédente | POST /v1/risk/check | Clé secrète Bearer | Distance, vitesse implicite et indicateur de voyage impossible |
Questions fréquentes
Watch-IP peut-il géolocaliser une adresse IP que je fournis ?
Oui. Utilisez l'API de recherche d'IP côté serveur avec une clé secrète. Le point de terminaison visiteur du navigateur localise le client connecté et n'accepte pas d'IP arbitraire à rechercher.
Puis-je utiliser Watch-IP depuis JavaScript dans un navigateur ?
Utilisez la géolocalisation du visiteur avec une clé publiable configurée pour l'origine de votre site. Les clés secrètes de recherche doivent rester sur votre backend et ne jamais apparaître dans du code navigateur.
La géolocalisation IP est-elle la même chose que l'API de géolocalisation du navigateur ?
Non. Watch-IP estime la localisation à partir d'une connexion IP. L'API de géolocalisation du navigateur est un mécanisme distinct qui peut demander la permission d'utiliser la position fournie par l'appareil.
Puis-je rechercher des adresses IPv4 et IPv6 ?
Les points de terminaison de recherche acceptent les adresses IPv4 et IPv6 valides, selon les enregistrements disponibles dans la base de données. La couverture des signaux de sécurité est une question distincte et varie selon l'indicateur et la version d'IP.
Watch-IP propose-t-il un forfait gratuit ?
Oui. Le forfait Free inclut un quota mensuel de requêtes ainsi qu'un quota plus restreint de recherches IP ; consultez la page des tarifs pour les limites actuelles. Les contrôles d'e-mail, d'inscription et de voyage impossible puisent dans le même quota, sans forfait séparé.
Le contrôle d'e-mail vérifie-t-il qu'une boîte aux lettres existe ?
Non. Watch-IP contrôle la syntaxe, le domaine (listes de domaines jetables, enregistrements de serveur de messagerie, ancienneté) et des motifs d'adresse comme les fautes de frappe et les adresses génériques. Il ne contacte pas le serveur de messagerie : aucun résultat ne confirme qu'une boîte aux lettres existe ou peut recevoir du courrier.
Les contrôles d'e-mail et de risque nécessitent-ils un forfait séparé ?
Non. Chaque adresse contrôlée, contrôle d'inscription ou contrôle de voyage impossible compte comme une requête sur le même quota mensuel que vos appels de géolocalisation et de recherche. Les endpoints backend utilisent une clé secrète émise depuis votre tableau de bord.
Un signal de sécurité négatif signifie-t-il que le visiteur est sûr ?
Non. Cela signifie que la vérification n'a trouvé aucune correspondance dans les données utilisées. L'absence de couverture, les réseaux non répertoriés et les signaux indisponibles doivent être considérés séparément.
Choisissez votre première intégration
Commencez par le guide visiteur pour un site web, la page produit de recherche IP pour une application backend, ou le contrôle d'e-mail pour votre formulaire d'inscription.