Endpoint 1: IP & Network Intelligence
Returns geographic estimation, ASN, CIDR routing prefix, reverse DNS hostname, RDAP organization, and proxy/VPN risk signals.
{ip_or_domain}Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q (or ip) | string | Yes | IPv4 address (e.g. 8.8.8.8), IPv6 address (e.g. 2001:4860::8888), or domain name (e.g. github.com). |
Endpoint 2: Caller IP Auto-Discovery
Returns the public IP address and connection version of the requesting client directly from edge network transit headers.
Code Integration Examples
cURL
curl -s "https://ip-address-lookup.com/api/lookup?q=8.8.8.8"JavaScript / Node.js
const res = await fetch('https://ip-address-lookup.com/api/lookup?q=8.8.8.8');
const data = await res.json();
console.log('IP: ' + data.ip + ' | Country: ' + data.country);Python
import requests
res = requests.get('https://ip-address-lookup.com/api/lookup?q=8.8.8.8')
data = res.json()
print('IP: ' + data['ip'] + ' | City: ' + data['city'])Go
package main
import (
"encoding/json"
"fmt"
"net/http"
)
func main() {
resp, _ := http.Get("https://ip-address-lookup.com/api/lookup?q=8.8.8.8")
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Printf("City: %v, ISP: %v\n", result["city"], result["isp"])
}Attribution Policy (KeyCDN Model)
Our API is free because we believe in open internet diagnostic tooling. If you use this API on your public website, mobile application, or open-source tool, you must link back to ip-address-lookup.com.
<a href="https://ip-address-lookup.com" target="_blank" rel="noopener">IP Lookup powered by ip-address-lookup.com</a>