Get started
Check your first IP address with VPNDetection in under a minute, then choose how to integrate: an SDK, web app middleware, the databases or no code.
VPNDetection tells you whether an IP address belongs to a VPN, a proxy, a Tor exit, a privacy relay or a hosting provider, and who operates it. This section takes you from your first request to an integration that is ready for real traffic.
How VPNDetection works
You send an IP address, and VPNDetection answers with what is known about it. Each kind of address has a yes-or-no flag, such as is_vpn or is_tor, and a detail object beside it that holds the evidence: who operates the address, how confident the classification is and when the address was last seen. The answer also says where the address is and which network announces it.
You decide what an answer means for your application. A sign-up form might ask a VPN user to confirm their email address, a login might ask for a second factor, and a streaming service might refuse VPN traffic that would get around its country rules. The guides show these decisions end to end.
The same answers are available three ways. The API answers one request per address. Middleware for your web framework looks up every visitor before your handler runs. The databases are files you download and query on your own servers, with no request per lookup.
Make your first request
The quickest way to see what VPNDetection returns is a single request. It needs no account and no API key:
curl https://api.vpndetection.io/45.83.91.1The Quickstart walks through that answer field by field and shows how to add a key.
Choose how to integrate
If you're not sure which path fits, start from what you're building:
| If you want to | Start with |
|---|---|
| Check sign-ups, logins or payments in a web app | Protect a web app |
| Look up addresses from a backend service, a worker or a script | Use an SDK |
| Enrich logs or analyze traffic you've already collected | Use the databases or Check addresses in bulk |
| Check a few addresses by hand | Look up addresses without code |
Understand the essentials
These pages explain the ideas every integration meets. Read them before you put VPNDetection in front of real traffic.
Next steps
When your integration works, review the go-live checklist before you put it in front of real traffic. To solve a specific problem, such as screening sign-ups or restricting content by country, see the guides.