Public IP Intelligence API
The read-only endpoint exposes the same core normalized IP data used by the website. If the advanced provider is configured, the response can also include normalized security intelligence. The free endpoint uses coarse daily rate limiting based on a one-way hash derived from the connecting IP and site identifier.
Endpoint
GET https://ip-lookup.com/api/v1/ip.php?ip=8.8.8.8
Example with curl
curl "https://ip-lookup.com/api/v1/ip.php?ip=1.1.1.1"
Response shape
{
"ok": true,
"data": {
"core": { "provider": "FreeIPAPI", "location": {}, "network": {} },
"advanced": null
},
"meta": { "rate_limit": { "limit": 100, "remaining": 99 } }
}
Usage rules
- One IP address per request.
- IPv4 and IPv6 are supported.
- Responses are JSON.
- The free limit defaults to 100 requests per connecting IP per UTC day and can be changed by the site operator.
- Geolocation and security fields are third-party classifications and can be approximate.
HTTP status codes
| Status | Meaning |
|---|---|
| 200 | Lookup completed. |
| 422 | Invalid or missing IP. |
| 429 | Daily free limit reached. |
| 502 | Upstream IP data service unavailable. |
Privacy
The API does not create a lookup-history database. The simple daily limiter writes a date and one-way hash with a request count, not the plaintext client IP. Normal hosting/security logs may still exist according to server configuration.