Watch-IP
API voor IP, e-mail en inlogrisico

IP-geolocatie, e-mailcontroles en inlogrisicosignalen uit één API.

Lokaliseer websitebezoekers vanuit de browser, zoek IP-adressen op vanuit je backend, spoor wegwerpdomeinen en typefouten op in aanmeld-e-mails en markeer onmogelijke reizen bij het inloggen — allemaal met één abonnement en één maandelijks aanvraagtegoed. De kaart toont een voorbeeld van de edge-gegevens en lokale verrijking van dit paginaverzoek; het is geen API-antwoord.

Edge-voorbeeld van paginaverzoekrequest.cf
Columbus, OH, US

216.73.216.231

Kaart met een markering boven Columbus
Coördinaten
39.9612, -82.9988
Tijdzone
America/New_York
Postcode
43215
Continent
NA
Netwerk
Anthropic, PBC
ASN
AS16509
Valuta
$ USD
Landcode
+1
Zonsopgang / zonsondergang
7:50 / 18:41
Apparaat
—
Beveiliging
Niet beschikbaar — niet gecontroleerd

Kies de API voor jouw taak

Bepaal de locatie van de bezoeker op je website

Roep de bezoekersgeolocatie-API rechtstreeks vanuit de browser aan met een publiceerbare sleutel die beperkt is tot je toegestane origins. Gebruik het geschatte land- en stadsgegeven, de tijdzone en beschikbare regionale context om een relevantere ervaring voor te stellen.

Bekijk bezoekersgeolocatie →

Zoek een IP op vanaf je backend

Heb je al een IP-adres in je applicatie? Stuur het naar het IP-lookup-endpoint vanaf je server. Een geheime sleutel authenticeert het verzoek, en het antwoord bevat locatievelden van een IP-geolocatiedatabase van een externe partij.

Bekijk de IP-lookup-API →

Verwerk een lijst met IP-adressen

Stuur tot 100 IP-adressen in één batchverzoek en ontvang een geordende lijst met lookupresultaten voor rapportage, verrijking en andere backend-workflows. Lookupgebruik wordt gemeten per IP, niet per batchverzoek.

Bekijk bulk IP-lookup →

E-mailadressen controleren bij aanmelding

Controleer syntaxis, bekende wegwerpdomeinen, of het domein een mailserver heeft, waarschijnlijke typefouten en rol-adressen, en ontvang een oordeel — accepteren, beoordelen of weigeren — met de redenen. Roep het aan vanuit je formulier met een publiceerbare sleutel, of controleer tot 100 adressen per verzoek — of lijsten tot 100.000 — vanuit je backend of het dashboard.

E-mailcontroles bekijken →

Een nieuwe aanmelding in één aanroep scoren

POST /v1/signup/check combineert de e-mailcontrole met het land en netwerk van het aanmeldende IP, abonnementsafhankelijke VPN-, Tor- en datacenterindicatoren en de leeftijd van het e-maildomein tot een score van 0–100 en een onderbouwd oordeel. De score is context voor je beslissing, geen bewijs van misbruik.

Bekijk de workflow tegen aanmeldmisbruik →

Onmogelijke reizen markeren bij het inloggen

POST /v1/risk/check vergelijkt de geschatte locatie van het inlog-IP met de vorige opgeslagen locatie van de gebruiker en geeft afstand, verstreken tijd, impliciete snelheid en een risiconiveau terug. Het kan fout-positieven opleveren en bewijst geen accountovername.

Detectie van onmogelijke reizen bekijken →

Voorbeeld van browserintegratie en edge-voorbeeld

Het voorbeeld laat zien hoe je GET /v1/geo vanuit een browser aanroept. Het is niet uitgevoerd om dit voorbeeld te genereren. De locatie komt van dit paginaverzoek; verrijking wordt lokaal afgeleid. Ontbrekende waarden zijn niet beschikbaar, en beveiligingscontroles worden niet uitgevoerd.

Voorbeeldverzoek — niet uitgevoerd

import { WatchIP } from "@digitload/watch-ip-sdk";

const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();

Voorbeeld van paginaverzoek — geen API-antwoord

{
  "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"
  }
}

Bezoekers- en backendgeolocatie

Gebruik GET /v1/geo in de browser van de bezoeker met een publiceerbare sleutel. Gebruik GET /v1/lookup/{ip} of POST /v1/lookup op je backend met een geheime sleutel voor opgegeven IP's.

Eén abonnement voor elke controle

Geolocatie, IP-lookup en e-mail-, aanmeld- en reiscontroles tellen allemaal mee voor hetzelfde maandelijkse aanvraagtegoed — één verzoek per aanroep, gecontroleerd IP of gecontroleerd adres. Er is geen apart product te koop, en elk abonnement, ook Free, kan beide sleuteltypen uitgeven.

E-mailcontroles op domeinniveau

E-mailcontroles kijken naar syntaxis, of het domein een wegwerpdomein is en naar zijn mailserverrecords, waarschijnlijke typefouten en rol-adressen. Ze nemen nooit contact op met de mailbox, dus geen enkel resultaat bevestigt dat een adres bestaat of e-mail kan ontvangen.

Aan origin gebonden sleutels

Je API-sleutel is publiceerbaar, net als een sleutel van Stripe of Google Maps. Verzoeken worden alleen bediend — en CORS wordt alleen toegekend — aan de origins die je registreert.

Edge-geolocatie

GET /v1/geo leest locatiegegevens op netwerkniveau voor het verbindende IP-adres. IP-locatie is geschat; de responstijd hangt af van het verzoek en ingeschakelde functies.

Regionale verrijking

Bezoekersantwoorden leiden valuta, landcode, zon-op- en ondergangstijden en apparaathints af van locatie- en verzoekheaders. Velden kunnen null zijn wanneer brongegevens niet beschikbaar zijn.

Regionale compliance-indicaties

Statische land- en regiokoppelingen bieden compliance-indicaties. Ze scheppen geen wettelijke verplichtingen en garanderen geen naleving.

Locale-bepaling, al voor je gedaan

Elk antwoord bevat een locale-object: de best passende BCP47-locale (waarbij het land van de bezoeker wordt gecombineerd met de Accept-Language-header van hun browser, zodat een Franstalige bezoeker in Canada fr-CA krijgt, niet fr-FR), plus maateenheidsstelsel, eerste dag van de week en datumnotatie — zo hoef je dit niet opnieuw te implementeren in je eigen i18n-laag.

Kalender met feestdagen

Elk antwoord bevat een holiday-object: of het vandaag een feestdag is in het land van de bezoeker, de naam ervan, en de eerstvolgende — handig voor "we zijn vandaag gesloten"-teksten in supportwidgets, berichten bij het afrekenen, of planningslogica, met dekking van een samengestelde lijst van ongeveer 40 landen.

Indicaties van leeftijdsjurisdictie

Statische koppelingen bieden indicaties voor leeftijd en jurisdictie op basis van de geschatte IP-locatie. Ze verifiëren geen identiteit of leeftijd; controleer geldende vereisten zelf.

Indicaties van belastingjurisdictie

Statische koppelingen bieden regionale belastingcontext. Ze zijn geen belastingberekening en geen vervanging voor een onderhouden belastingengine.

SDK-broncodepakketten

De repository bevat clients voor JavaScript/TypeScript, Python, PHP, Go en Flutter/Dart. Endpointondersteuning varieert; raadpleeg de documentatie en controleer de beschikbaarheid van het package voordat je installeert.

VPN-, Tor- en netwerksignalen

In aanmerking komende bezoekersabonnementen bevatten op lijsten gebaseerde indicatoren voor VPN, Tor, datacenter, dreiging en gesanctioneerde netwerken. Een vals signaal betekent geen match in de beschikbare gegevens, geen veilige bezoeker. IPv6-dekking is gedeeltelijk; IPv6-Tor wordt niet gedekt.

Merkgebonden subdomeinen

Growth en Scale bevatten een pad voor het instellen van een aangepast domein in het dashboard. Beschikbaarheid hangt af van accountgeschiktheid en een geslaagde DNS- en SSL-configuratie; integraties moeten de geconfigureerde basis-URL gebruiken.

Signaal voor onmogelijke reizen

POST /v1/risk/check vergelijkt de geschatte locatie van een opgegeven IP met een opgeslagen gebruikersbaseline. Het kan valse positieven opleveren en bewijst geen accountovername. Neem contact met ons op om beschikbaarheid en toewijzing te bevestigen.

Begrijp het antwoord voordat je gaat integreren

De bezoekers- en lookup-API's bedienen verschillende verzoeken en geven verschillende gegevens terug. Bezoekersgeo gebruikt de edge-geolocatie van het binnenkomende verzoek en voegt regionale context toe. IP-lookup lost het door jou opgegeven adres op met een geolocatiedatabase van een externe partij. Lookupantwoorden bevatten niet alle verrijking die bezoekersgeo biedt — postcode en tijdzone worden bijvoorbeeld niet geleverd door de huidige brondataset. E-mail-, aanmeld- en risicocontroles werken elk met de invoer die je stuurt — een adres, of een gebruikers-ID en IP — en elke rij hieronder telt mee voor hetzelfde maandelijkse aanvraagtegoed.

Jouw taakEndpointSleutelFocus van de gegevens
Bepaal de locatie van de binnenkomende websitebezoekerGET /v1/geoPubliceerbaar, beperkt tot originBezoekerslocatie en regionale context
Zoek één opgegeven IP opGET /v1/lookup/{ip}Geheime Bearer-sleutelLocatieresultaat van externe database
Zoek meerdere opgegeven IP's opPOST /v1/lookupGeheime Bearer-sleutelTot 100 geordende locatieresultaten
Een e-mailadres controleren in een aanmeldformulierPOST /v1/email/validatePubliceerbaar, beperkt tot originSignalen voor syntaxis, wegwerpdomein, mailserver en typefouten, met een oordeel
E-mailadressen in bulk controlerenPOST /v1/email/batch, /v1/email/jobsGeheime Bearer-sleutelTot 100 per verzoek, of tot 100.000 per asynchrone lijsttaak
Een nieuwe aanmelding scorenPOST /v1/signup/checkGeheime Bearer-sleutelScore van 0–100 op basis van e-mail-, IP-netwerk- en domeinleeftijdsignalen
Een login vergelijken met de vorige locatiePOST /v1/risk/checkGeheime Bearer-sleutelAfstand, impliciete snelheid en markering voor onmogelijke reis

Veelgestelde vragen

Kan Watch-IP een door mij opgegeven IP-adres geolocaliseren?

Ja. Gebruik de server-side IP-lookup-API met een geheime sleutel. Het bezoekers-endpoint in de browser bepaalt de locatie van de verbindende client en accepteert geen willekeurig IP-adres om op te zoeken.

Kan ik Watch-IP vanuit JavaScript in een browser gebruiken?

Gebruik bezoekersgeo met een publiceerbare sleutel die is geconfigureerd voor de origin van je website. Geheime lookupsleutels horen thuis op je backend en mogen nooit in browsercode voorkomen.

Is IP-geolocatie hetzelfde als de Geolocation API van de browser?

Nee. Watch-IP schat de locatie op basis van een IP-verbinding. De Geolocation API van de browser is een apart mechanisme dat toestemming kan vragen voor locatiegegevens van het apparaat.

Kan ik IPv4- en IPv6-adressen opzoeken?

De lookup-endpoints accepteren geldige IPv4- en IPv6-adressen, afhankelijk van de beschikbare databaserecords. De dekking van beveiligingssignalen is een aparte kwestie en varieert per indicator en IP-versie.

Heeft Watch-IP een gratis abonnement?

Ja. Het Free-abonnement bevat een maandelijks aanvraagtegoed en een kleiner tegoed voor IP-lookups; zie de prijspagina voor de actuele limieten. E-mail-, aanmeld- en reiscontroles tellen mee voor hetzelfde tegoed, zonder apart abonnement.

Controleert de e-mailcontrole of een mailbox bestaat?

Nee. Watch-IP controleert syntaxis, het domein (wegwerplijsten, mailserverrecords, leeftijd) en adrespatronen zoals typefouten en rolaccounts. Er wordt geen contact opgenomen met de mailserver, dus geen enkel resultaat bevestigt dat een mailbox bestaat of e-mail kan ontvangen.

Hebben e-mail- en risicocontroles een apart abonnement nodig?

Nee. Elk gecontroleerd adres, elke aanmeldcontrole en elke reiscontrole telt als één verzoek op hetzelfde maandelijkse tegoed als je geolocatie- en lookup-aanroepen. Backend-endpoints gebruiken een geheime sleutel die je in je dashboard aanmaakt.

Betekent een vals beveiligingssignaal dat de bezoeker veilig is?

Nee. Het betekent dat de controle geen match vond in de gebruikte gegevens. Ontbrekende dekking, niet-vermelde netwerken en niet-beschikbare signalen moeten apart worden beoordeeld.

Kies je eerste integratie

Begin met de bezoekersgids voor een website, de productpagina voor IP-lookup voor een backendapplicatie, of de e-mailcontrole voor je aanmeldformulier.