IP Geolocation API
Get accurate location data from any IP address. Returns country, city, timezone, currency, ISP information, and security threat detection.
/api/v1/ip/lookupTry it out
/api/v1/ip/lookupParameters
Code
curl -X GET "https://khaleejiapi.dev/api/v1/ip/lookup?ip=8.8.8.8" \ -H "Authorization: Bearer your_api_key"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ip | string | Required | IPv4 or IPv6 address to lookup |
| fields | string | Optional | Comma-separated list of fields to return |
Response Fields
country, country_code
ISO 3166-1 country name and alpha-2 code
city, region, postal_code
City-level location data with postal/ZIP code
latitude, longitude
Geographic coordinates of the IP location
connection
ISP, organization, ASN, and connection type (residential, datacenter, mobile)
security
Threat detection flags for proxy, VPN, Tor, and datacenter IPs
Rate Limits
| Plan | Requests/Month | Rate Limit |
|---|---|---|
| Free | 1,000 | 10 req/min |
| Starter | 10,000 | 60 req/min |
| Professional | 100,000 | 300 req/min |
| Business | 500,000 | 1,000 req/min |
Debugging & Support
Include X-Request-ID when contacting support
Every response from KhaleejiAPI includes an X-Request-ID header — a unique identifier that lets our support team pull the exact log entry for your request within seconds. Always share it when reporting an unexpected error or unexpected result.
How to capture it
JavaScript / fetch
const res = await fetch("https://khaleejiapi.dev/api/v1/...", {
headers: { Authorization: "******" },
});
const requestId = res.headers.get("x-request-id");
console.log("Request ID:", requestId);
// → e.g. "req_01j9xkz4vp8..."cURL
curl -si "https://khaleejiapi.dev/api/v1/..." \ -H "Authorization: ******" | grep -i x-request-id # → x-request-id: req_01j9xkz4vp8...
Browser DevTools
Open DevTools (F12) → Network tab → click the failing request → scroll to the Response Headers section → copy the value next to x-request-id.
For a full list of error codes and guidance on common issues, see the Troubleshooting guide.