apipick IP Geolocation
Look up location and network information for any public IPv4 or IPv6 address.
Endpoint
GET https://www.apipick.com/api/ip-geolocation
Authentication: x-api-key: YOUR_API_KEY header required.
Get a free API key at https://www.apipick.com/dashboard/api-keys
Request
# Look up a specific IP
GET /api/ip-geolocation?ip=8.8.8.8
# Look up caller's own IP (omit parameter)
GET /api/ip-geolocation
Response
{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}
city, latitude, longitude may be empty or null for some IPs.
Error Codes
| Code | Meaning |
|---|---|
| 400 | Invalid or private/reserved IP address |
| 401 | Missing or invalid API key |
| 402 | Insufficient credits |
| 404 | No geolocation data available for this IP |
| 503 | Geolocation database temporarily unavailable |
Cost: 1 credit per request
Usage Pattern
- Use
$APIPICK_API_KEYenv var as thex-api-keyheader value; if not set, ask the user for their apipick API key - Make the GET request (with or without
ipquery parameter) - Present location data in a readable format
See references/api_reference.md for full response field descriptions.