- name
- apipick-ip-geolocation
- description
- Look up geographic location and network information for any IPv4 or IPv6 address using the apipick IP Geolocation API. Returns country, continent, city, latitude/longitude, timezone, currency, ISP, and ASN. Use when the user wants to geolocate an IP address, find the country or city for an IP, identify the ISP or ASN of an IP, look up timezone or currency for an IP, or check their own public IP location. Omit the IP parameter to look up the caller's own IP. Requires an apipick API key (x-api-key). Get a free key at https://www.apipick.com.
- metadata
- openclaw
- requires
- env
- primaryEnv
- APIPICK_API_KEY
apipick IP Geolocation
Look up location and network information for any public IPv4 or IPv6 address.
Endpoint
GET https://www.apipick.com/api/ip-geolocationAuthentication: 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-geolocationResponse
{
"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.