Look up the geographic location of any IP address. Get country, city, timezone, ISP, and coordinates in milliseconds. No signup form — get your API key with a single request.
No API key needed for demo. Production use requires a free key.
// Click "Look Up IP" to see resultsCountry, country code, region, city, latitude, longitude, and postal code for any IPv4 or IPv6 address.
ISP name, organization, AS number, and connection type. Identify VPNs, proxies, and hosting providers.
IANA timezone identifier, UTC offset, and local currency code. Perfect for localization.
Look up 100 IPs in a single request. Ideal for log analysis, fraud detection, and bulk processing.
Calculate the distance between two IPs or coordinates. Returns distance in km and miles.
Call the endpoint without an IP to automatically detect and geolocate the caller's IP address.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/geo/{ip} | Geolocate a single IP address |
| GET | /api/geo/me | Geolocate the caller's IP |
| GET | /api/geo/batch?ips=1.1.1.1,8.8.8.8 | Batch lookup (up to 100 IPs) |
| GET | /api/geo/timezone/{ip} | Get timezone info for an IP |
| GET | /api/geo/distance?from=...&to=... | Distance between two IPs |
# Look up an IP address
curl "https://agent-gateway-kappa.vercel.app/api/geo/8.8.8.8" \
-H "Authorization: Bearer YOUR_API_KEY"
# Auto-detect your own IP
curl "https://agent-gateway-kappa.vercel.app/api/geo/me" \
-H "Authorization: Bearer YOUR_API_KEY"
# Batch lookup
curl "https://agent-gateway-kappa.vercel.app/api/geo/batch?ips=1.1.1.1,8.8.8.8,208.67.222.222" \
-H "Authorization: Bearer YOUR_API_KEY"const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://agent-gateway-kappa.vercel.app';
// Look up any IP
const res = await fetch(`${BASE}/api/geo/8.8.8.8`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await res.json();
console.log(data.city); // "Mountain View"
console.log(data.country); // "United States"
console.log(data.timezone); // "America/Los_Angeles"import requests
API_KEY = "YOUR_API_KEY"
BASE = "https://agent-gateway-kappa.vercel.app"
# Look up any IP
r = requests.get(
f"{BASE}/api/geo/8.8.8.8",
headers={"Authorization": f"Bearer {API_KEY}"}
)
data = r.json()
print(data["city"]) # Mountain View
print(data["country"]) # United States
print(data["timezone"]) # America/Los_AngelesDetect visitor location to show local currency, language, shipping options, or region-specific content automatically.
Compare user-claimed location with IP geolocation. Flag mismatches for payment processing and account security.
Map where your users come from. Build geographic heatmaps and understand traffic patterns by region.
Identify user jurisdiction to apply correct privacy regulations and display appropriate consent notices.
/api/keys/create and you'll receive your API key instantly. No email, no signup form, no credit card./api/geo/batch) accepts up to 100 IP addresses in a single request, returning geolocation data for all of them. Each IP in the batch costs 1 credit.200 free credits. No signup form. No credit card. Start geolocating IPs in seconds.
Get Started Free