IP Geolocation API
Simple. Accurate. Reliable.

API Guide

Get started in under a minute. No SDKs, no tokens to refresh, no complex setup.

1. Get Your API Key

After purchasing a plan, your API key is available instantly in the My Licenses section of your client area. Each subscription generates a unique key prefixed with geo-free- (Free) or geo-pro- (Pro).

2. Make Your First Request

Send a GET request to the lookup endpoint with your API key. The API accepts both IPv4 and IPv6 addresses, and will resolve hostnames automatically.

# Look up an IP address
curl https://edznet.io/api/geo/v1/lookup?key=geo-free-xxxxxxxxxx&ip=8.8.8.8

# Or use the X-API-Key header
curl https://edznet.io/api/geo/v1/lookup \
  -H "X-API-Key: geo-free-xxxxxxxxxx" \
  -G -d "ip=8.8.8.8"

# Resolve a hostname
curl "https://edznet.io/api/geo/v1/lookup?key=geo-free-xxxxxxxxxx&ip=edznet.io"

// Look up an IP address
$key = 'geo-free-xxxxxxxxxx';
$ip  = '8.8.8.8';

$ch = curl_init("https://edznet.io/api/geo/v1/lookup?key=$key&ip=$ip");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['country']; // "United States"

// Look up an IP address
const key = 'geo-free-xxxxxxxxxx';
const ip  = '8.8.8.8';

const response = await fetch(
  'https://edznet.io/api/geo/v1/lookup?key=' + key + '&ip=' + ip
);
const data = await response.json();
console.log(data.country); // "United States"

# Look up an IP address
import requests

key = 'geo-free-xxxxxxxxxx'
ip  = '8.8.8.8'

response = requests.get(
    'https://edznet.io/api/geo/v1/lookup',
    params={'key': key, 'ip': ip}
)
data = response.json()
print(data['country'])  # United States

3. Response Format

All responses are returned as JSON. A successful lookup includes the following fields:

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "country_code": "US",
  "country": "United States",
  "region": "California",
  "city": "Mountain View",
  "post_code": "94043",
  "latitude": "37.405000",
  "longitude": "-122.078000",
  "timezone": "America/Los_Angeles",
  "utc_offset_seconds": -25200,
  "is_dst": true,
  "asn": 15169,
  "isp": "Google LLC",
  "is_proxy": false,
  "is_datacenter": true,
  "connection_type": "hosting",
  "flag": "https://edznet.io/api/geo/v1/flags/us",
  "flag_emoji": "🇺🇸",
  "continent": "NA",
  "continent_name": "North America",
  "is_eu_member": false,
  "currency": "USD",
  "currency_symbol": "$",
  "local_time": "2026-06-30T12:34:56",
  "plan": {
    "tier": "free",
    "limit": 100,
    "used": 12,
    "remaining": 88,
    "resets_at": "2026-07-01T00:00:00Z"
  }
}

4. Errors & Rate Limits

The API uses standard HTTP status codes to indicate success and failure:

When you exceed your monthly rate limit, the API returns 429 and includes X-RateLimit-* headers with reset information. Usage resets on the 1st of each month (UTC). Your current usage is always visible in the plan field of every response.

Every response also includes rate limit information in HTTP headers — useful if you want to check usage without parsing the response body:

# Headers returned with every successful response
X-RateLimit-Tier: free
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 88
X-RateLimit-Reset: 2026-07-01T00:00:00Z

6. Country Flags

Need a flag icon to accompany your lookup results? Use the flags endpoint to get a transparent PNG by country code:

curl https://edznet.io/api/geo/v1/flags/us

# Returns a 16x12 PNG of the US flag
# Display in HTML: <img src="https://edznet.io/api/geo/v1/flags/us" alt="US">