VPN Blocker

Free plan: 10,000 lookups a month

The Free plan gives you an API key with 10,000 lookups a month. Every answer says whether the IP is a VPN, proxy, Tor exit, privacy relay or hosting address, how confident we are, and who owns the network. It’s enough to build and test an integration, or to protect a small site’s sign-up and login pages. The card you add at sign-up is never charged.

Get a free API key

Free

$0
per month

A card on file is required at sign up. It is not charged.

Get started free

What’s included

  • Included: 10,000 lookups a monthResets at 00:00 UTC on the 1st of every month
  • Included: HTTPS (SSL) lookups in JSON, XML or HTML
  • Included: Basic response fieldshost-ip, categories (VPN, proxy, Tor, relay, hosting), confidence and org
  • Included: Dashboard, usage stats and alerts
  • Included: IP reportsTell us about an IP address you think is wrong
  • Included: Email support
  • Not included: Hostname and IP geolocationAvailable on Professional and Business

What a lookup returns

{
    "status": "success",
    "package": "Free",
    "remaining_requests": 9876,
    "ipaddress": "159.203.0.1",
    "host-ip": true,
    "categories": ["hosting"],
    "confidence": 90,
    "org": "DigitalOcean, LLC"
}

categories says what kind of address it is, and confidence (0–99) says how sure we are. host-ip is true for hosting, data center and VPN networks. org names the network’s owner. See the docs for how to turn this into block, challenge or allow.

Get started in three steps

  1. Create an account

    Sign up at dashboard.vpnblocker.net, verify your email, and add a card. It isn’t charged.

  2. Copy your free API key

    It starts with vpb_.

  3. Make your first lookup

    Send your key in the X-API-KEY header:

curl -H "X-API-KEY: vpb_YOUR_API_KEY" https://api.vpnblocker.net/v2/json/8.8.8.8

How the limit works

Your 10,000 lookups reset at 00:00 UTC on the 1st of every month. Only successful lookups count; errors don’t. The dashboard shows your daily usage and emails you as you get close. At 10,000 the API returns 429 Too Many Requests with a Retry-After header until the reset. There’s no buffer on Free, so cache answers for about an hour and check only the pages that matter.

Good to know

  • One free API key per account.
  • A card on file is required but never charged. Prepaid cards can’t be used for the Free plan, and each card can unlock the Free plan for one account.
  • The Free plan stops at 10,000 lookups. After that the API returns HTTP 429 until the limit resets on the 1st of the month (UTC).
  • Need more? Upgrade your key to a paid plan at any time from the dashboard.

Free plan FAQ

Does the Free plan include Tor and proxy detection?

Yes. Every plan returns the same categories and confidence score. Paid plans differ in volume, and Professional and up add hostname and geolocation.

API documentation

← All plans