Skip to content

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.

1 creditValidateCSV bulkMCP
POST/v1/ip-intelligence
{
  "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"
  }
}
[01/Response]

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.
[02/Capabilities]

What IP Intelligence does

01

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.

02

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.

03

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.

04

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.

[03/Try it]

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.

POST /v1/ip-intelligence1 credit

IPv4 or IPv6

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

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)
[05/Use cases]

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.

[06/Cost]

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
PlanPer 1,000 creditsPer 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
[07/FAQ]

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.

[ Validate ][ Enrich ]
[Get started]

Run IP Intelligence on your own data

Starter is $29 a month for 6,000 credits, enough for 6,000 lookups a month.

[ Screen ][ Scrape ]