Skip to content
VPNDetection

FAQ

Answers to common questions about VPNDetection: keys, commercial use, IPv6, browsers, how fresh the data is, accuracy, privacy and service levels.

Short answers to the questions we hear most. Each answer links to the page that covers its topic in full.

Basics

Do I need an API key?

No. Without a key, every lookup answers with the free plan's fields, with no daily or monthly cap. A key on a paid plan adds every other field. See Plans and fields.

Where do I find my API key?

In the console, under API > Keys. Select Show key to reveal it. The console creates your first key when you create your account.

Can I call the API from a web page?

Yes. The API accepts requests from any web page. Call it without a key from the page, because a key in a page can be read by anyone who opens it; the free plan's fields answer without one. To use a key, call the API from your server instead.

Does VPNDetection support IPv6?

Yes. Every lookup, batch and database accepts IPv6 addresses as well as IPv4 addresses.

Plans and usage

Can I use the free plan commercially?

Yes. You can use the free plan's answers in a commercial product. You can't resell or redistribute them, or use them to build a competing service. See the terms.

What happens when a paid plan's quota runs out?

Lookups keep working, with the free plan's fields and cap_reached: true, and they aren't charged. To keep every field, turn on overage in Billing. See Plans and fields.

Is there a rate limit?

Yes. A rate limit protects the service from bursts. A rate-limited request answers 429 with a Retry-After header, and the official libraries wait and retry for you. See Rate Limits.

Data and accuracy

How fresh is the data?

The API answers from the current build of each database. Each database's page in the Database Reference gives its update schedule, and each field that records a date, such as last_seen, says when an address was last observed.

Does VPNDetection detect residential proxies?

Yes, on a paid plan. is_resproxy flags addresses seen in residential proxy pools, with the pool's provider and how often and how recently the address was seen. See the IP lookup reference.

What's the difference between a VPN and a privacy relay?

A VPN user chooses where they appear to be, often in another country. A privacy relay, such as iCloud Private Relay, hides the user's address but keeps their country. VPNDetection flags them separately, as is_vpn and is_relay. See Handle privacy relays.

Why is an address flagged that I think is clean?

Addresses change hands, and home connections can be rented out as proxies without their owners' knowledge. The details that come with each flag, such as when the address was last seen, help you judge how much weight to give it. If you think a flag is wrong, send us the address.

Will blocking VPNs turn away real customers?

It can. Many people use a VPN for privacy, so many sites ask a flagged visitor for more verification instead of refusing them. See Screen VPN and proxy sign-ups.

Can I use VPNDetection offline?

Yes, with the databases. You download a file and look addresses up on your own servers, with no request per lookup. See Use the databases.

Privacy and service

Do you store the addresses I look up?

The privacy policy describes what we keep and for how long. A data processing agreement is available.

Is there an SLA?

Contact sales to discuss service levels for your organization.

How do I report a problem?

See Support and status, which lists where to send each kind of report and what to include.