The ipapi.is API tells you who owns an IPv4 or IPv6 address, where it is, and what kind of address it is: a datacenter, a VPN (and which one), a proxy, a Tor node or a known abuser. One request, one JSON object. A free account includes 1,000 requests a day, commercial use included.
- VPN detection that names the service. ipapi.is connects to 73 VPN services around the clock and records the addresses their traffic leaves from, so it knows exit nodes from observation and can say whose they are.
- Hosting detection beyond the big clouds. More than 29,000 hosting providers are tracked, thousands of them small hosts that publish no range list.
- The owner down to the customer. Nearly 8 million WHOIS networks, each with the organization, its type (hosting, ISP, business, education, government, banking) and the abuse contact.
- A free tier you can build on. 1,000 requests a day with the complete response, for commercial products too. More than two billion requests are served a month.
curl "https://api.ipapi.is/?q=187.13.197.43&key=your_api_key&v=1"{
"ip": "187.13.197.43",
"rir": "RIPE",
"is_bogon": false,
"is_mobile": false,
"is_satellite": false,
"is_anycast": false,
"is_crawler": false,
"is_datacenter": true,
"is_tor": false,
"is_proxy": false,
"is_vpn": true,
"is_abuser": false,
"vpn": {
"service": "NordVPN",
"type": "exit_node",
"last_seen_str": "2026-11-13T14:55:05.677Z",
"exit_node_region": "France #1168"
},
"datacenter": {
"datacenter": "PacketHub S.A.",
"network": "187.13.197.0 - 187.13.197.255"
},
"company": {
"name": "PacketHub S.A.",
"abuser_score": "0.0117 (Elevated)",
"type": "hosting"
},
"abuse": {
"email": "abuse@packethub.tech"
},
"asn": {
"asn": 212238,
"org": "Datacamp Limited",
"type": "hosting"
},
"location": {
"country": "France",
"city": "Marseille 01",
"timezone": "Europe/Paris",
"accuracy": "MEDIUM"
}
}The response is shortened here; all fields are listed below.
- Create a free account and copy the API key from the dashboard.
- Send the address as
qand the key askey. Leave outqto look up the address the request comes from. - Send
v=1with them. It names the response format described here, so your code keeps getting it when a newer format appears.
JavaScript (Node.js 18 or newer). The key travels in a POST body, which keeps it out of URLs and logs:
const res = await fetch('https://api.ipapi.is', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ q: '187.13.197.43', key: process.env.IPAPI_KEY, v: 1 }),
});
const info = await res.json();
console.log(info.is_vpn, info.vpn.service, info.location.country); // true NordVPN FrancePython:
import os
import requests
def lookup(ip):
res = requests.post('https://api.ipapi.is',
json={'q': ip, 'key': os.environ['IPAPI_KEY'], 'v': 1}, timeout=5)
res.raise_for_status()
return res.json()
info = lookup('187.13.197.43')
print(info['is_vpn'], info['vpn']['service'], info['location']['country']) # True NordVPN FranceKeep the key on your server. A key in browser JavaScript or in a public repository will be found and spent by someone else.
The API also answers without a key: 30 requests a day per client address, with the owner and the location, and without the detection flags.
curl "https://api.ipapi.is/?q=187.13.197.43"{
"ip": "187.13.197.43",
"is_bogon": false,
"company": "PacketHub S.A.",
"asn": "AS212238 Datacamp Limited",
"city": "Marseille 01",
"region": "Provence-Alpes-Côte d'Azur",
"country": "France",
"lat": 43.2951,
"lon": 5.3861,
"timezone": "Europe/Paris",
"docs": "https://ipapi.is/free-tier.html?ref=api"
}Refuse signups from VPNs, proxies and Tor. An Express route:
const express = require('express');
const app = express();
app.set('trust proxy', 1); // behind a load balancer, so that req.ip is the visitor
app.post('/signup', async (req, res) => {
const ip = await fetch('https://api.ipapi.is', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ q: req.ip, key: process.env.IPAPI_KEY, v: 1 }),
}).then((r) => r.json()).catch(() => ({})); // if the lookup fails, let people in
if (ip.is_vpn || ip.is_proxy || ip.is_tor) {
return res.status(403).json({ error: `Signups through ${ip.vpn?.service ?? 'a VPN or proxy'} are not accepted.` });
}
res.json({ ok: true }); // create the account
});ipapi.is-node packs this into a middleware, guard(), with caching and a choice of what to block.
Find the datacenter traffic in an access log. A bulk request takes up to 100 addresses; this prints the busiest clients that are servers, with their hosting provider:
awk '{print $1}' access.log | sort | uniq -c | sort -rn | head -100 | awk '{print $2}' \
| jq -R . | jq -s '{ips: ., key: env.IPAPI_KEY, v: 1}' \
| curl -s https://api.ipapi.is -H 'Content-Type: application/json' -d @- \
| jq -r 'to_entries[] | select(.value.is_datacenter?) | "\(.key)\t\(.value.datacenter.datacenter)"'85.10.199.76 Hetzner Online GmbH
3.5.140.2 Amazon AWS
165.227.0.0 DigitalOcean
Find out where to report an attacker.
curl -s "https://api.ipapi.is/?q=107.174.138.172&key=$IPAPI_KEY&v=1" | jq .abuse{
"name": "VPS ACE",
"address": "350 Main Street, Buffalo, NY, 14202, US",
"email": "support@vpsace.com",
"phone": "+1-855-587-7223"
}List every prefix of a network. An AS number as q returns the autonomous system with all the routes it announces:
curl -s "https://api.ipapi.is/?q=AS16509&key=$IPAPI_KEY&v=1" | jq '{org, type, prefixes: (.prefixes | length)}'{
"org": "Amazon.com, Inc.",
"type": "hosting",
"prefixes": 17305
}Give it to an LLM. https://api.ipapi.is/toon?q=… returns the same data as TOON, which takes fewer tokens than JSON. There is also /html for reading in a browser, /csv and /text.
| Field | Meaning |
|---|---|
ip, rir |
The address, and the registry its WHOIS record comes from |
is_bogon |
A private, reserved or special address |
is_datacenter, datacenter |
It belongs to a hosting, cloud or CDN provider; the object names the provider and its range |
is_vpn, vpn |
It is a VPN exit node or server; the object names the service and says when the node was last seen and where it is |
is_proxy |
A known open proxy |
is_tor |
A node of the Tor network: an exit node or another relay |
is_abuser |
Recently seen attacking, spamming or scanning, by blocklists or our own honeypots |
is_crawler |
false, or the name of the bot that uses the address: GoogleBot, BingBot, ClaudeBot and several hundred more |
is_mobile, is_satellite |
It belongs to a mobile carrier or to a satellite ISP such as Starlink |
is_anycast |
It answers from many places at once, like 1.1.1.1 |
egress_service |
Its traffic comes from a managed service, not from its owner: a secure web gateway such as Zscaler, iCloud Private Relay, a public DNS resolver, an email gateway |
company |
The organization the address is registered to: name, domain, type, network and the share of the network seen in abuse |
abuse |
Where to report abuse: name, address, email and phone |
asn |
The autonomous system that announces the address: number, organization, type, route |
location |
Country, state, city, postal code, coordinates, timezone, local time, currency, and how accurate the location is |
Every field is described in the documentation, and the API has an OpenAPI description and an llms.txt for AI agents.
Errors are JSON with a message in error and a stable error_code, such as ERR_INVALID_IP_OR_ASN (400), ERR_FORBIDDEN_INVALID_API_KEY (403) or ERR_QUOTA_EXCEEDED (429). A request without a key that goes over the daily limit gets 429 ERR_FREE_TIER_EXHAUSTED with a Retry-After header; stop there, because a client that keeps sending is blocked for 24 hours.
| Requests | Response | |
|---|---|---|
| Without a key | 30 a day per client address | Owner and location |
| Free account | 1,000 a day, commercial use included | Complete |
| One-time credits | 30,000 per dollar, they never expire | Complete |
| Subscription | A fixed daily amount, billed monthly | Complete |
The free tier is not a trial: if 1,000 requests a day are enough, you never pay. Pricing. The Business plan includes every database and a single Linux binary that serves the whole API from your own infrastructure.
The API runs on servers in Germany, the United States and Singapore. api.ipapi.is sends each request to the nearest healthy one; the status page shows them all.
The data behind the API can be downloaded, for lookups without a network call.
- Free IP geolocation database: 4.8 million IPv4 and 1.4 million IPv6 ranges with country, state, city, coordinates and timezone, as CSV under CC BY-SA 4.0. IPv4, IPv6, and how to use it, including the conversion to MMDB.
- Samples of the commercial databases in
databases/: hosting ranges, VPN exit nodes, ASNs, companies, abusive addresses and full geolocation, each in CSV and MMDB. Their formats are documented in ipapi-is/ipapi.
- Detecting VPN services by enumerating their exit nodes
- An algorithm to detect hosting providers and their IP ranges
- Crawling the complete IPv4 reverse DNS space
- Scraping the complete IPv4 WHOIS address space
- IP geolocation accuracy benchmark: 18 providers against GPS positions, live
Found wrong data? Report it on the corrections page. Questions go to info@ipapi.is.
The code and documentation in this repository are under the MIT license. The free geolocation database is under CC BY-SA 4.0: use it for any purpose, including commercial ones, if you credit ipapi.is with a link, as described in databases/LICENSE-free-geolocation-database.txt. The sample files show the format of the commercial databases, which are licensed under the ipapi.is terms.