Kies een abonnement voor de API die je nodig hebt

Elke geauthenticeerde aanroep die door de sleutel- en origincontrole komt, telt als één verzoek: een bezoekersgeolocatie-aanroep, elk opgezocht IP, elk gecontroleerd e-mailadres, elke aanmeldcontrole en elke reiscontrole. Een aanroep die daarna op invoervalidatie faalt, telt ook mee. Aanroepen die worden geweigerd door een ontbrekende of ongeldige sleutel, een niet-toegestane origin of de rate limit per minuut tellen niet mee, en het verwijderen van een risicobaseline of het opvragen van de status van een e-maillijsttaak evenmin.

Het is een vast venster van één minuut, gelijk aan de kloktijd — geen voortschrijdend gemiddelde. Op het Free-abonnement kun je bijvoorbeeld tot 30 verzoeken doen tussen 10:32:00 en 10:32:59; de teller wordt om 10:33:00 weer op nul gezet. Bij overschrijding krijg je een HTTP 429 met een Retry-After-header die aangeeft over hoeveel seconden het venster opnieuw begint. Dit staat los van je maandelijkse verzoekvolume hieronder — het beperkt de piekbelasting, niet het totale gebruik. De limiet telt API-aanroepen, geen items: een batch van maximaal 100 IP's of e-mailadressen, of het aanmaken van een e-maillijstjob, telt als één verzoek — terwijl elk IP of adres daarin nog steeds apart meetelt voor je maandelijkse verzoekvolume.

We schakelen je sleutel niet automatisch uit. Als je structureel dicht bij de limiet van je abonnement zit, kun je op elk moment upgraden vanuit je dashboard — zonder wijzigingen in code of API-sleutel.

Bezoekersgeolocatie leest edge-verzoekgegevens en leidt regionale verrijking lokaal af, waardoor de kosten — en de prijs — ver onder de vergelijkbare niveaus van de meeste providers blijven. Server-side IP-lookup is gebundeld in hetzelfde abonnement en dezelfde prijs in plaats van apart verkocht te worden: elk abonnement bevat zowel een verzoeklimiet als een IP-lookupquotum, beide afkomstig uit de gedeelde maandelijkse pool van dat abonnement.

Antwoorden van bezoekersgeolocatie en IP-lookup bevatten regionale verrijking wanneer brongegevens beschikbaar zijn. In aanmerking komende abonnementen bevatten ook op lijsten gebaseerde beveiligingsindicatoren. E-mailcontroles geven een apart resultaat op domeinniveau terug. De latentie varieert per verzoek en ingeschakelde functies.

Ja. GET /v1/geo blijft uitsluitend de client-side self-lookup van de bezoeker, die het IP-adres herleidt dat daadwerkelijk verbinding maakt. Voor het opzoeken van een willekeurig IP-adres zijn GET /v1/lookup/{ip} (enkel) en POST /v1/lookup (batch, tot 100 IP's per aanroep) server-naar-server-endpoints die worden geauthenticeerd met een geheime sleutel in plaats van je publiceerbare sleutel — de sleutel blijft op je backend en wordt nooit naar een browser verzonden. Beide zijn gebaseerd op een IP-geolocatiedatabase van een derde partij in plaats van onze eigen realtime netwerkgegevens, met een andere responsstructuur en zonder geverifieerde relatieve nauwkeurigheidsrangschikking — zie de gegevensbronnen voor de specifieke provider en vereiste attributie — en het gebruik wordt in rekening gebracht per opgezocht IP-adres, onttrokken aan de gedeelde maandelijkse pool van je abonnement één-op-één met een geo-verzoek (zie het IP-lookupquotum van je abonnement hierboven voor de aparte limiet op het totale aantal lookups). Omdat dit endpoint IP's opzoekt die door je klant worden aangeleverd in plaats van door de bezoeker die op eigen initiatief belt, maakt dit Watch-IP tot verwerker van die gegevens van derden namens jou — zie de DPA voor wat dit betekent voor je eigen complianceverplichtingen.

POST /v1/risk/check vergelijkt de door een derde partij herleide locatie van een opgegeven IP met een opgeslagen gebruikersbaseline en geeft een laag/gemiddeld/hoog risico en een impossibleTravel-vlag terug. Het gebruikt een geheime backend Bearer-sleutel. Neem contact met ons op om beschikbaarheid, toewijzing en prijzen te bevestigen; onafhankelijke handhaving per abonnement en gereedheid voor checkout zijn niet geverifieerd. VPN-wisselingen en mobiele routering kunnen valse positieven veroorzaken.

Ja. POST /v1/email/validate gebruikt een publiceerbare, origin-gebonden sleutel om syntaxis, bekende wegwerpdomeinen, de aanwezigheid van een mailserver voor het domein, waarschijnlijke typefouten en rol-adressen te controleren, en geeft een onderbouwd oordeel: accepteren, beoordelen of weigeren. Vanuit je backend controleert POST /v1/email/batch tot 100 adressen per aanroep, verwerken lijsttaken er tot 100.000, en voegt POST /v1/signup/check de netwerksignalen van het aanmeldende IP toe. Elk gecontroleerd adres telt als één verzoek op het maandtegoed van je abonnement (een lijsttaak rekent elk uniek adres één keer). Geen van deze controles neemt contact op met de mailbox, dus ze verifiëren niet het bestaan, het eigenaarschap of de bezorgbaarheid van een mailbox.

Dat hangt af van het sleuteltype. Publiceerbare sleutels — voor GET /v1/geo en POST /v1/email/validate — zijn bedoeld om in de paginabron te staan, net als een publiceerbare Stripe- of Google Maps-sleutel; de toegangscontrole is de origin-binding: elke sleutel werkt alleen vanaf de domeinen die je registreert, en CORS wordt alleen verleend aan een overeenkomende origin. Geheime sleutels — voor IP-lookup, bulk-e-mailcontrole, aanmeld- en reiscontroles — moeten op je backend blijven en mogen nooit in browsercode verschijnen.

Er zijn SDK-broncodepakketten voor JavaScript/TypeScript, Python, PHP, Go en Flutter/Dart. Controleer de beschikbaarheid in de registry en de endpointondersteuning voor gebruik. GET /v1/geo bepaalt altijd de locatie van de verbindende aanroeper; een backend-aanroep bepaalt niet de locatie van je websitebezoeker. Gebruik lookup met een geheime sleutel voor een opgegeven IP.

Ja, maar het is opt-in: voeg ?include=hostname toe aan het verzoek (of include: ["hostname"] in de SDK) en het antwoord krijgt een hostname-veld, opgelost via een reverse-DNS-opzoeking over DNS-over-HTTPS. Het is null wanneer er geen PTR-record is. In tegenstelling tot de altijd actieve verrijkingsvelden hierboven voert dit een echte netwerkopzoeking binnen het verzoek uit, dus staat het standaard uit in plaats van elke aanroep te vertragen.

In aanmerking komende abonnementen bevatten de op lijsten gebaseerde vlaggen isVpn, isTor, isDatacenter, isThreat en isSanctionedNetwork in zowel bezoekersgeolocatie- als IP-lookup-antwoorden; Free laat beveiliging weg. IPv4 ondersteunt lijst- en ASN-matching. IPv6 ondersteunt VPN-, datacenter- en dreigingsbereiken plus ASN-matching, maar heeft geen Tor-dekking. De dekking in productie hangt af van de beschikbare feeds. False betekent geen match in de beschikbare gegevens, geen garantie van veiligheid; deze signalen zijn geen definitieve sanctiescreening.

Ja — elk antwoord bevat een compliance-object: isGDPR (EU/EER + VK), usPrivacyLaw (de van toepassing zijnde Amerikaanse deelstaatwet, bijv. CCPA/CPRA of VCDPA, gebaseerd op de staat van de bezoeker), isLGPD (Brazilië), een afgeleide requiresCookieConsent-vlag, een grove dataResidencyZone, en isEmbargoedCountry (uitgebreide OFAC-landembargo's). Dit is bij elk abonnement zonder extra kosten inbegrepen, net als valuta en landcode. Het is een eerste jurisdictiesignaal berekend op basis van de locatie van de bezoeker, geen juridisch advies — bevestig nalevingsvereisten altijd bij je eigen juridisch adviseur.

Ja — elk antwoord bevat een locale-object: suggestedLocale is een BCP47-locale die het land van de bezoeker combineert met de eigen Accept-Language-header van hun browser, met voorkeur voor een taal die daar daadwerkelijk wordt gesproken (een Accept-Language van "fr" van een Canadese bezoeker levert bijvoorbeeld "fr-CA" op, niet "fr-FR"), met een terugval naar de standaardlocale van het land wanneer niets in de header overeenkomt. Hetzelfde object bevat ook measurementSystem (metrisch/imperiaal), firstDayOfWeek en dateFormat, zodat je regionale opmaakconventies niet zelf opnieuw hoeft af te leiden. Dit is bij elk abonnement zonder extra kosten inbegrepen.

Ja — elk antwoord bevat een holiday-object: isPublicHolidayToday, todayHolidayName en nextHoliday (datum en naam) voor het land van de bezoeker, berekend op basis van een samengestelde statische tabel (momenteel ongeveer 40 landen — G20 + de EU/EER + VK) afkomstig van Nager.Date en handmatig ververst op een cadans van eens of twee keer per jaar in plaats van een berekening op het moment van het verzoek. Het is null voor landen buiten die lijst, en telt alleen landelijke feestdagen mee, geen regionale of provinciale vrije dagen. Bij elk abonnement zonder extra kosten inbegrepen; meer landen zijn op aanvraag toe te voegen.

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.