IP Geolocation API docs
Get country, city, ISP, timezone, currency, and threat score for any IP address. Supports IPv4 and IPv6.
Authentication
All IP Geolocation API requests authenticate via two headers. Get your API key from your RapidAPI dashboard after subscribing on the Basic (free) tier or higher.
X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: ip-geolocation-by-helix-api.p.rapidapi.com
Base URL
https://ip-geolocation-by-helix-api.p.rapidapi.com
Endpoints
GET
/lookup/{ip}Full geolocation for an IP
GET
/lookup/meLookup caller's IP
POST
/bulkLookup up to 20 IPs
Code Examples
Python
import requests
url = "https://ip-geolocation-by-helix-api.p.rapidapi.com/lookup/{ip}"
headers = {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "ip-geolocation-by-helix-api.p.rapidapi.com",
}
response = requests.get(url, headers=headers)
print(response.json())JavaScript
const response = await fetch(
"https://ip-geolocation-by-helix-api.p.rapidapi.com/lookup/{ip}",
{
method: "GET",
headers: {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "ip-geolocation-by-helix-api.p.rapidapi.com"
}
}
);
const data = await response.json();cURL
curl -X GET "https://ip-geolocation-by-helix-api.p.rapidapi.com/lookup/{ip}" \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: ip-geolocation-by-helix-api.p.rapidapi.com"Response Format
All endpoints return JSON in this consistent envelope:
{
"status": "ok",
"data": { /* endpoint-specific payload */ },
"meta": {
"cached": false,
"latency_ms": 142,
"request_id": "req_abc123"
},
"timestamp": "2026-05-21T12:00:00Z"
}Error Codes
| HTTP | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Missing or invalid parameter |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Your plan doesn't include this endpoint |
| 429 | RATE_LIMIT_EXCEEDED | Too many requests — back off and retry |
| 500 | INTERNAL_ERROR | Something went wrong on our side |
| 503 | UPSTREAM_UNAVAILABLE | A third-party data source is down |
Common Use Cases
Fraud detection
Content localization
Ad targeting
Analytics
Access control
GDPR compliance geofencing
Bot detection and filtering
Regional pricing pages
VPN and proxy detection
User registration validation
Geo-targeted push notifications
Shipping cost estimation
Tax jurisdiction detection
Content licensing enforcement
Multi-region load balancing
Login anomaly detection
Audience segmentation
Compliance audit logging
Location-based feature flags
ISP throttle detection