IP Geolocation API

Map any IP address to a location

One REST call returns the country, city, coordinates, and timezone for an IP address. Send an IP, or leave it blank to locate the caller. Built for developers.

Get your free API key See the response
✓ 50,000 lookups/month free ✓ No credit card ✓ Cancel anytime
Try it · live
Enter an IP address

Returns country, city, latitude, longitude, and timezone. Leave blank to look up your own IP.

— ms 0 used today 500 left today
One call, every field

What comes back

Location data for the IP, from country all the way down to city and postal code where available.

ipAddress
country
countryCode
region
city
postalCode
latitude
longitude
continent
timezone
Built for real-world input

What you can do with it

Enough location signal to personalize, route, and analyze by geography.

Country down to city

country, region, city, and postal code where the IP resolves that far.

Coordinates and timezone

latitude, longitude, continent, and timezone on every lookup.

IPv4 and IPv6

8.8.8.8 or 2001:4860:4860::8888 → both address formats accepted

Look up the caller

send no IP and it geolocates the request's own address.
Where teams use it

Common use cases

Localize contentSet the default currency, language, or region from the visitor's IP.
Risk and fraud signalsFlag mismatches between the IP location and the account.
Analytics by regionGroup traffic and events by country, region, or city.
Route to the nearest regionSend users to the closest server or data center.
Copy, paste, ship

A single GET request

Send an IP, get its location back. No SDK required.

Request
# IP in, location out
curl "https://api.sthan.io/IpGeolocation/72.229.28.185" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "ipAddress": "72.229.28.185",
  "country": "United States",
  "countryCode": "US",
  "region": "New York",
  "city": "New York",
  "latitude": 40.7263,
  "longitude": -73.9818,
  "continent": "North America",
  "timezone": "America/New_York",
  "postalCode": "10009"
}
Simple pricing

Start free, scale when you need to

A generous free tier, then plans by request volume. Annual saves up to about 40%.

Start here
Free
$0
50,000 lookups / month
No credit card
Basic
$4.50 /mo
100,000 lookups
Starter
$32 /mo
1,000,000 lookups
Business
$120 /mo
5,000,000 lookups

Higher volumes and annual discounts on the plans page.

See all plans
Good to know

Questions developers ask

What data does it return?

Country, region, city and postal code where available, plus latitude, longitude, continent, and timezone for the IP you send.

Does it accept IPv4 and IPv6?

Yes. Send either format. Leave the input blank and it geolocates the caller's own IP.

How precise is the location?

IP geolocation resolves to a city or region, not a street address. Some IPs, such as large infrastructure ranges, resolve only to a country.

What do I need to get started?

An email address. Sign up, grab your API key, and send your first request. The free tier gives you 50,000 lookups a month with no card on file.

Locate your first IP in two minutes

Sign up, copy your key, make the call. 50,000 lookups a month, free.

Get your free API key