A curl IP Geolocation One-Liner (No API Key)

The Short Answer

To geolocate your own IP from the terminal in one line, run curl https://hackmyip.com/api/ip. It returns JSON with your city, region, country, latitude/longitude, ISP, ASN, and a VPN/proxy/datacenter flag — no API key, no signup. To geolocate any IP, run curl 'https://hackmyip.com/api/lookup?ip=8.8.8.8'. Use the web lookup tool if you want a map and a UI.

Your Own IP

curl https://hackmyip.com/api/ip

For a quick human-readable location without the rest of the payload, the bare-root JSON is even smaller:

curl hackmyip.com/json

Any IP

curl 'https://hackmyip.com/api/lookup?ip=1.1.1.1'

Note the quotes around the URL — the ? and & in query strings need them in most shells.

Parse Just the City and Country

With jq installed, you can pull out exactly the fields you want:

# City and country for any IP

Geolocate Many IPs at Once

Looping curl over a list works, but the batch endpoint is one round trip for up to 50 addresses:

curl -X POST -H "Content-Type: application/json" \

For a bigger list and loop guidance, see bulk IP lookup.

A Note on Accuracy

IP geolocation maps an address to a city and region, not a street. It is an estimate drawn from upstream public databases and can be off, especially for mobile, CGNAT, and VPN/proxy IPs. That last case is exactly why the response also includes a VPN/proxy/datacenter flag: to tell you when the "location" is really a server, not a person. To check whether your own connection looks like a proxy, see the proxy and VPN detector, and to learn how the mapping works, read how IP geolocation works.

Frequently Asked Questions

How do I geolocate an IP with curl?

Run curl 'https://hackmyip.com/api/lookup?ip=8.8.8.8' to geolocate any IP, or curl https://hackmyip.com/api/ip for your own. Both return JSON with city, region, country, ISP, and ASN, with no API key.

Can I get IP geolocation without an API key?

Yes. HackMyIP's geolocation endpoints are free and need no key or signup. You call the URL directly with curl, fetch, or any HTTP client.

How accurate is curl-based IP geolocation?

It resolves to a city and region, not a precise address, and is an estimate from public databases. Mobile, CGNAT, and VPN/proxy IPs are the least accurate, which is why the response includes a VPN/proxy/datacenter flag to mark those cases.

How do I extract just the city from the response?

Pipe the response through jq, for example curl -s 'https://hackmyip.com/api/lookup?ip=8.8.8.8' | jq -r '.data.city'. For the minimal shape, curl hackmyip.com/json returns city and country directly.

Can I geolocate many IPs in one call?

Yes. POST up to 50 IPs to https://hackmyip.com/api/bulk in a single request. For larger lists, loop the batch endpoint; see the bulk IP lookup page for guidance.