Skip to content

Platform_

Geo & IP intelligence

Turn an IP into a place — country, region, city, timezone.

Resolve any address to a country and city from the local MaxMind database, or read the caller straight off the Cloudflare edge. Country accuracy runs ~99%; city is honest about being lower, and nullable fields never pretend otherwise.

Why it works_

Where is this request coming from — really

01

Two resolution paths

The edge driver reads the caller from Cloudflare headers; the database driver places any arbitrary IP you supply. Neither can be misused as the other.

02

Honest precision

Country is near-certain, city is 60–70% and often null. The response says so instead of inventing a city.

03

No raw IP stored

Request logs keep a salted hash of the address, never the address itself.

The data behind it

One call, these response blocks.

This page maps to these blocks of the same response every other page reads:

  • Geo & IP
  • Network & fraud
geo-ip-intelligence.sh
curl "https://api.localesense.com/v1/lookup?ip=203.135.62.10" \
  -H "Authorization: Bearer ls_live_..."
In practice

What your code sees, per request.

The sample on the right is the shape of the real response for a visitor in Karachi — every value attributable, nothing guessed. Point the same call at any of the 197 markets.

Try it live in the docs
GET /v1/self 200 OK · sample
  • Geo PK · Karachi · under 50ms
  • Risk 12/100 · no VPN · BIN match

Keep exploring_

Related platform

FAQs

Geo & IP intelligence — frequently asked

How accurate is IP geolocation for finding a country?

Country-level resolution is roughly 99% accurate, which is what commerce decisions like currency and tax rely on. City-level accuracy is lower — typically 60–70% — and we return null rather than guess when the database is not confident.

Can I look up any IP address, or only the visitor's?

Both, through two separate paths. /v1/self reads the caller straight off the Cloudflare edge; /v1/lookup?ip= places any arbitrary address you pass from the MaxMind database. The two are distinct methods so neither can be misused as the other.

Do you store the IP addresses I look up?

No. We keep only a salted hash of the address in request logs — enough to rate-limit and debug, never the raw IP, so there is no personal-data retention to worry about.

Get started

Try it free

10,000 requests a month, no card. Every tier includes live FX and the full formatting engine.

Get your API key