Choisissez un forfait pour l'API dont vous avez besoin

Chaque appel authentifié qui passe les contrôles de clé et d'origine compte comme une requête : un appel de géolocalisation visiteur, chaque IP recherchée, chaque adresse e-mail contrôlée, chaque contrôle d'inscription et chaque contrôle de voyage impossible. Un appel qui échoue ensuite à la validation des entrées compte quand même. Les appels rejetés pour une clé absente ou invalide, une origine non autorisée ou la limite de débit par minute ne comptent pas, pas plus que la suppression d'une référence de risque ou l'interrogation d'une tâche de liste d'e-mails.

C'est une fenêtre fixe d'une minute, alignée sur la minute de l'horloge — pas une moyenne glissante. Sur le forfait Free, vous pouvez effectuer jusqu'à 30 requêtes entre, disons, 10:32:00 et 10:32:59 ; le compteur revient à zéro à 10:33:00. Un dépassement renvoie un HTTP 429 avec un en-tête Retry-After indiquant le nombre de secondes avant la réinitialisation de la fenêtre. C'est indépendant de votre volume mensuel de requêtes ci-dessous — cela plafonne le débit en rafale, pas l'usage total. La limite compte les appels API, pas les éléments : un lot de jusqu'à 100 IP ou adresses e-mail, ou la création d'une tâche de liste d'e-mails, compte pour une seule requête — alors que chaque IP ou adresse qu'il contient compte toujours séparément dans votre volume mensuel de requêtes.

Nous ne coupons pas votre clé automatiquement. Si vous approchez régulièrement du plafond de votre forfait, passez à un forfait supérieur à tout moment depuis votre tableau de bord — aucun changement de code ou de clé API nécessaire.

La géolocalisation du visiteur lit les données de la requête en périphérie et dérive l'enrichissement régional localement, ce qui maintient son coût — et son prix — bien en dessous des paliers équivalents de la plupart des fournisseurs. La recherche d'IP côté serveur est intégrée au même forfait et au même prix plutôt que vendue séparément : chaque forfait inclut à la fois un plafond de requêtes et un quota de recherches d'IP puisés dans le pool mensuel partagé de ce forfait.

Les réponses de géolocalisation des visiteurs et de recherche IP incluent un enrichissement régional lorsque les données sources sont disponibles. Les forfaits éligibles incluent aussi des indicateurs de sécurité basés sur des listes. Les contrôles d'e-mail renvoient un résultat distinct, au niveau du domaine. La latence varie selon la requête et les fonctionnalités activées.

Oui. GET /v1/geo reste uniquement l'auto-recherche du visiteur, côté client, résolvant l'IP qui se connecte réellement. Pour la recherche d'une IP arbitraire, GET /v1/lookup/{ip} (unitaire) et POST /v1/lookup (par lots, jusqu'à 100 IP par appel) sont des endpoints serveur à serveur authentifiés avec une clé secrète plutôt que votre clé publique — la clé reste sur votre backend et n'est jamais envoyée à un navigateur. Les deux s'appuient sur une base de données de géolocalisation IP tierce plutôt que sur nos propres données réseau en temps réel, avec une structure de réponse différente et sans classement de précision relative vérifié — voir les sources de données pour le fournisseur exact et l'attribution requise — et l'utilisation est facturée par IP recherchée, puisée dans le pool mensuel partagé de votre forfait à raison d'une pour une avec une requête de géolocalisation (voir le quota de recherches d'IP de votre forfait ci-dessus pour le plafond distinct sur le nombre total de recherches). Parce que cet endpoint recherche des IP fournies par votre client plutôt que le visiteur appelant de son propre chef, cela fait de Watch-IP un sous-traitant de ces données tierces pour votre compte — consultez le DPA pour ce que cela implique pour vos propres obligations de conformité.

POST /v1/risk/check compare la localisation résolue par un tiers d'une IP fournie à une référence utilisateur stockée et renvoie un risque faible/moyen/élevé ainsi qu'un indicateur impossibleTravel. Il utilise une clé secrète backend Bearer. Contactez-nous pour confirmer la disponibilité, la mise en service et la tarification ; l'application indépendante du forfait de risque et la disponibilité du paiement n'ont pas été vérifiées. Les changements de VPN et le routage mobile peuvent provoquer des faux positifs.

Oui. POST /v1/email/validate utilise une clé publiable, verrouillée par origine, pour contrôler 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 renvoie un verdict accepter, examiner ou rejeter avec ses raisons. Depuis votre backend, POST /v1/email/batch contrôle jusqu'à 100 adresses par appel, les tâches de liste en traitent jusqu'à 100 000, et POST /v1/signup/check ajoute les signaux réseau de l'IP qui s'inscrit. Chaque adresse contrôlée compte comme une requête sur le quota mensuel de votre forfait (une tâche de liste facture chaque adresse distincte une seule fois). Aucun de ces contrôles ne contacte la boîte aux lettres : ils ne vérifient ni l'existence, ni la propriété, ni la délivrabilité d'une boîte.

Cela dépend du type de clé. Les clés publiables — utilisées pour GET /v1/geo et POST /v1/email/validate — sont faites pour figurer dans le code source de la page, comme une clé publiable Stripe ou Google Maps ; le contrôle d'accès repose sur le verrouillage par origine : chaque clé ne fonctionne que depuis les domaines que vous enregistrez, et CORS n'est accordé qu'à une origine correspondante. Les clés secrètes — utilisées pour la recherche IP, le contrôle d'e-mails en masse, les contrôles d'inscription et de voyage impossible — doivent rester sur votre backend et ne jamais apparaître dans du code navigateur.

Des paquets SDK source existent pour JavaScript/TypeScript, Python, PHP, Go et Flutter/Dart. Vérifiez la disponibilité sur le registre et la prise en charge des points de terminaison avant utilisation. GET /v1/geo localise toujours l'appelant connecté ; un appel backend ne localise pas le visiteur de votre site. Utilisez la recherche par clé secrète pour une IP fournie.

Oui, mais c'est optionnel : ajoutez ?include=hostname à la requête (ou include: ["hostname"] dans le SDK) et la réponse gagne un champ hostname, résolu via une recherche PTR DNS-over-HTTPS. Il est vide (null) en l'absence d'enregistrement PTR. Contrairement aux champs d'enrichissement toujours actifs ci-dessus, cela effectue une vraie recherche réseau à l'intérieur de la requête, donc c'est désactivé par défaut plutôt que d'ajouter de la latence à chaque appel.

Les forfaits éligibles incluent les indicateurs basés sur des listes isVpn, isTor, isDatacenter, isThreat et isSanctionedNetwork, dans les réponses de géolocalisation des visiteurs comme de recherche IP ; le forfait Free omet la sécurité. L'IPv4 prend en charge la correspondance par listes et par ASN. L'IPv6 prend en charge les plages VPN, datacenter et menaces ainsi que la correspondance par ASN, mais n'a aucune couverture Tor. La couverture en production dépend des flux disponibles. False signifie aucune correspondance dans les données disponibles, pas une garantie de sécurité ; ces signaux ne constituent pas un filtrage de sanctions définitif.

Oui — chaque réponse inclut un objet compliance : isGDPR (UE/EEE + Royaume-Uni), usPrivacyLaw (la loi d'État américain applicable, par ex. CCPA/CPRA ou VCDPA, selon l'État du visiteur), isLGPD (Brésil), un indicateur requiresCookieConsent dérivé, une dataResidencyZone approximative, et isEmbargoedCountry (embargos pays complets de l'OFAC). Il est inclus sans coût supplémentaire sur tous les forfaits, comme la devise et l'indicatif téléphonique. C'est un signal de juridiction de premier niveau calculé à partir de la localisation du visiteur, pas un avis juridique — confirmez toujours les exigences de conformité avec vos propres conseils.

Oui — chaque réponse inclut un objet locale : suggestedLocale est un paramètre régional BCP47 qui combine le pays du visiteur avec l'en-tête Accept-Language de son propre navigateur, en privilégiant une langue réellement parlée à cet endroit (par ex. un Accept-Language « fr » depuis un visiteur canadien donne « fr-CA », pas « fr-FR »), et se rabat sur le paramètre régional par défaut du pays si rien dans l'en-tête ne correspond. Le même objet inclut aussi measurementSystem (métrique/impérial), firstDayOfWeek et dateFormat, pour éviter de redériver vous-même les conventions de formatage régionales. Inclus sans coût supplémentaire sur tous les forfaits.

Oui — chaque réponse inclut un objet holiday : isPublicHolidayToday, todayHolidayName et nextHoliday (date et nom) pour le pays du visiteur, calculés à partir d'une table statique organisée (environ 40 pays actuellement — G20 + UE/EEE + Royaume-Uni) issue de Nager.Date et actualisée manuellement une ou deux fois par an plutôt qu'au moment de la requête. Il est vide (null) pour les pays hors de cette liste, et ne compte que les jours fériés nationaux, pas les observances propres à un État ou une province. Inclus sans coût supplémentaire sur tous les forfaits ; d'autres pays peuvent être ajoutés sur demande.

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.