Skip to content
iplogs.comSign up

Check your visitors in the browser

A plain IP lookup sees an address. This check runs in your visitor's browser and sees the connection itself: how the handshake looks, which DNS resolver answers, whether their IPv4 and IPv6 agree, whether their time zone and language fit the address. That is how a VPN exit that no list names can still read as one. Add one script tag and read the answer in JavaScript. No key, no sign-up.

<script src="https://iplogs.com/iplogs.js" data-callback="onIplogs" async></script>

onIplogs(result, error) runs once, with the result or an error. Or call iplogs.check(), which returns a Promise of the result.

Pick your platform

<script src="https://iplogs.com/iplogs.js" async></script>
<script>
  window.addEventListener("load", function () {
    if (!window.iplogs) return; // blocked: let the visitor through
    iplogs.check().then(function (result) {
      if (result.is_vpn || result.is_proxy || result.is_tor) {
        // show a notice, ask for another step, or tag it in your analytics
      }
    }, function () { /* timed out or failed: let the visitor through */ });
  });
</script>

index.htmlPaste before </body>: Webflow, Wix, Squarespace, Ghost, any page

What comes back

verdictclean, suspicious, vpn_likely or vpn_detected
score0 to 1
is_vpn, is_proxy, is_torThe three flags to act on
is_relayiCloud Private Relay or Cloudflare WARP. Leave it out of a rule to let those visitors through
is_hostingA datacenter or cloud address
proxy_typeresidential, isp, public or datacenter when is_proxy is true, otherwise empty
vpn_providerThe VPN brand when one is known, otherwise empty
ip, country_code, asn, orgThe address and the network behind it
modefast when the answer came from memory without live probing, otherwise empty
request_idThe id of this check
signalsThe type and weight of each signal that fired, without detail text

Before you rely on it

It is a signal, not proof. The check runs in the visitor's browser, and anyone can edit page JavaScript. Use it to show a notice, add a step or tag analytics. To enforce a decision, such as a payment or a sign-up bonus, call the API from your server with the visitor's IP: see client code.

Fail open. If the script is blocked, the visitor is offline or the check takes longer than 25 seconds, check() rejects. Let the visitor through.

Content-Security-Policy. If your site sets one, allow script-src https://iplogs.com and frame-src https://iplogs.com. The check's own requests happen inside our frame, so your connect-src stays as it is.

Speed and limits. A full check probes the address and takes about 3 seconds. The answer is kept for 10 minutes in the tab's sessionStorage. iplogs.check({ mode: "fast" }) answers at once from memory, without live probing. The API's limits apply to each visitor's own address, not to your site.

What we receive. The visitor's IP address, time zone and language, plus technical details of the connection. We set no cookies. The privacy policy says how long logs are kept. You may need to mention the check in your own privacy notice.

Hand it to your AI coding assistant

Paste this into Cursor, Copilot, Windsurf or any assistant that edits your project. It has everything needed to wire the check into your stack.

Add an iplogs.com check of the visitor's own connection to this project.

What it does: tells us whether the visitor is on a VPN, proxy, Tor or datacenter connection. It runs in the browser and sees more than an IP lookup does (the connection handshake, the DNS resolver, IPv4 against IPv6, time zone).

How to wire it up:
1. Load https://iplogs.com/iplogs.js with an async script tag. It adds window.iplogs.check(), which returns a Promise of the result. No key, no package.
2. The result has: verdict ("clean", "suspicious", "vpn_likely" or "vpn_detected"), score (0 to 1), is_vpn, is_proxy, is_tor, is_relay, is_hosting, ip, country_code, asn, org, request_id.
3. Treat is_vpn || is_proxy || is_tor as "masked". Leave is_relay (iCloud Private Relay, Cloudflare WARP) out unless I say otherwise.
4. Fail open: if check() rejects (script blocked, offline, 25 second timeout), let the visitor through.
5. Call it once per page load. Answers are reused for 10 minutes in sessionStorage. check({ mode: "fast" }) answers at once from memory, without live probing.
6. Do not block payments, sign-ups or logins on this alone: the result is produced in the visitor's browser and can be edited. Use it to show a notice, add a step, or tag analytics. To enforce a decision, call POST https://iplogs.com/v1/check from the server with {"ip": "<visitor ip>"} (see https://iplogs.com/sdks).
7. If the site sets a Content-Security-Policy, allow script-src https://iplogs.com and frame-src https://iplogs.com.

Use my project's framework, language and code style. If it is unclear where the decision should be made or what should happen to a masked visitor, ask me before writing code.

The same page as plain Markdown for agents: integrations.md.

Pin a version

The script runs inside your page, so you may want a file that cannot change under you. This one never does: the browser refuses it if a single byte differs from the hash.

<script src="https://iplogs.com/iplogs/1.0.0.js"
        integrity="sha384-FBkrH4hznwNpOahOChEPs68P4K9mvVj9k1mDFiJGpLj8il9N75mOGkYSe/LaLku/"
        crossorigin="anonymous" async></script>

Prefer to load nothing from us? The No script from us tab above is the same check as a plain iframe and a message listener that you own.