| name | ip-lookup |
| description | Get geolocation, ISP, and network info for any IP address using ip-api.com. |
IP Lookup
Get geolocation, ISP, and network info for any IP address using ip-api.com.
Category: security
API Key Required: No
When to use
- User wants to geolocate an IP address
- User asks "where is this IP from?"
- User wants ISP, organization, or timezone for an IP
- User wants their own public IP info
How it works
Base URL: http://ip-api.com (HTTP only on free tier)
1. Look up a specific IP
curl -s "http://ip-api.com/json/8.8.8.8"
Returns: country, region, city, lat/lon, timezone, ISP, org, AS number.
2. Look up your own IP
curl -s "http://ip-api.com/json/"
3. Batch lookup (up to 100 IPs)
curl -s -X POST "http://ip-api.com/batch" \
-H "Content-Type: application/json" \
-d '["8.8.8.8","1.1.1.1","208.67.222.222"]'
4. Specific fields only
curl -s "http://ip-api.com/json/8.8.8.8?fields=country,city,isp,query"
Examples
User: "Where is 1.1.1.1 located?"
→ Query ip-api. Reply: "1.1.1.1 is operated by Cloudflare, located in San Francisco, US."
User: "Look up these IPs: 8.8.8.8, 1.1.1.1"
→ Use batch endpoint. Show country, city, ISP for each.
Constraints
- Free tier: HTTP only (no HTTPS), 45 requests/minute
- Do not use for commercial purposes without a paid plan
- Results are approximate — city-level accuracy at best