IP intelligence API for location, network and VPN detection
Send an IPv4 or IPv6 address and get back where it is, which network owns it, and whether it is a VPN, proxy, Tor exit, relay or datacenter address. Each lookup costs 1 credit.
{
"success": true,
"data": {
"ip": "203.0.113.42",
"version": 4,
"location": {
"country": "NL",
"country_name": "Netherlands",
"region": "North Holland",
"city": "Amsterdam",
"latitude": 52.3676,
"longitude": 4.9041,
"timezone": "Europe/Amsterdam"
},
"network": {
"isp": "Example Cloud Hosting",
"organization": "Example Cloud B.V.",
"asn": 64500,
"connection_type": "hosting"
},
"privacy": {
"vpn": true,
"proxy": false,
"tor": false,
"relay": false,
"hosting": true
},
"blocklists": {
"listed": false,
"count": 0
},
"risk": {
"level": "medium",
"factors": [
"vpn",
"hosting"
]
}
},
"meta": {
"credits_used": 1,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}What you get back
The fields most teams branch on. The full response is in the sample on this page and in the API reference.
location.cityLocationCity, with region, country, coordinates and time zone in the same object.network.ispISPThe provider that routes the address, next to the organization it is registered to.network.asnASNThe autonomous system number announcing the address, handy for grouping traffic by network.network.connection_typeConnection typeresidential, mobile, business or hosting, so you can tell a home user from a server.privacy.vpnPrivacy flagsTrue when the address belongs to a VPN. Proxy, Tor, relay and hosting each get their own boolean.blocklists.listedBlocklist statusWhether the address currently appears on public spam blocklists, and on how many.risk.levelRisk levelA low, medium or high rating, with the contributing flags listed in risk.factors.What IP Intelligence does
Geolocation down to the city
Each lookup returns country, region, city, latitude, longitude and time zone. IP geolocation is approximate by nature, so treat the city as an estimate and do not expect a street address.
Network ownership
The response names the ISP, the registered organization and the ASN behind the address. Use the ASN to rate limit or review traffic by network instead of chasing single addresses.
Five separate anonymizer flags
VPN, proxy, Tor, relay and hosting are reported as individual booleans. A privacy relay on a phone and a Tor exit node are different situations, and separate flags let you treat them differently.
Blocklists and a risk level
Every address is checked against public spam blocklists, and the result feeds a low, medium or high risk level. The factors come back with it, so the level is an input to your own rules and not a verdict you have to take on faith.
See the response before you sign up
Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.
Fill in the field and run the lookup to see what comes back.
One POST request
Send JSON with a Bearer key. The same key works for all 79 products.
curl -X POST https://api.1lookup.dev/v1/ip-intelligence \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip":"203.0.113.42"}'- Endpoint
POST /v1/ip-intelligence- Base URL
https://api.1lookup.dev- Request
ip- Price
- 1 credit
- Coverage
- Global, IPv4 and IPv6
- Bulk
- CSV upload and bulk API
- Cache
- Repeats within 7 days are free
- Also via
- Dashboard and MCP server (run_lookup)
What teams use it for
Screen logins and signups
Look up the client IP when an account is created or a session starts. Send Tor and datacenter traffic to a challenge and let ordinary residential connections straight through.
Localize content and pricing
Read the country and time zone to pick a default language, currency or regional catalog before the visitor chooses one.
Enforce regional restrictions
Compare the IP country with the places you are licensed to sell or stream. Read the VPN and proxy flags at the same time, because a location only means something when the address is not masked.
Clean up analytics and ad traffic
Run logged IPs through the bulk API and filter out hosting and proxy addresses. What remains is closer to human traffic.
IP geolocation is an estimate. City-level results can be off, especially on mobile and corporate networks, and an IP address identifies a network connection, not a person. IP geolocation by DB-IP (db-ip.com), CC BY 4.0.
1 credit
Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.
See pricing| Plan | Per 1,000 credits | Per 1,000 lookups |
|---|---|---|
| Starter $29/mo | $4.83 | $4.83 |
| Growth $99/mo | $3.96 | $3.96 |
| Pro $299/mo | $3.32 | $3.32 |
| Scale $799/mo | $2.66 | $2.66 |
IP Intelligence questions
What does the IP intelligence API return?
Geolocation (country, region, city, coordinates, time zone), network details (ISP, organization, ASN, connection type), five privacy flags, public blocklist status and a risk level. It all arrives in one JSON object.
Does IP Intelligence work with IPv6 addresses?
Yes. Send either an IPv4 or an IPv6 address in the ip field, from any country. Private and reserved ranges, such as 10.0.0.0/8, have no public location to report.
How accurate is IP geolocation?
It is an estimate. An IP address maps to the place a network hands out addresses, not to a device, so build rules on country and region and treat city as approximate. Mobile carriers and corporate networks often route traffic through a city far from the user.
How much does an IP lookup cost?
A single credit covers one address. Looking up the same IP again within 7 days is answered from cache for free, and you can pass "fresh": true when you need a new reading.
Can it tell me who is behind a VPN?
No. It tells you that an address belongs to a VPN, proxy, Tor or hosting network. It does not reveal the person or the original address, and no detection method catches every new server on its first day.
Related products
Reverse IP Lookup
The company and contact details associated with a visitor's IP address.
Fraud Detection
One rule-based fraud score from any mix of email, phone and IP signals.
Signup Check
Allow, review or block a new signup, with the reasons, in one call.
Run IP Intelligence on your own data
Starter is $29 a month for 6,000 credits, enough for 6,000 lookups a month.