wheresthatip

IP geolocation from the command line. Look up any IP address to get city, country, ISP, and coordinates.

$ wheresthatip

  IP            203.0.113.42
  City          San Francisco
  State         California
  Country       United States
  ISP           Comcast Cable Communications
  Coordinates   37.7749, -122.4194

  Details: https://www.wheresthatip.com/ip/203.0.113.42

Install

npm install -g wheresthatip

Usage

Show your public IP and location

wheresthatip

Look up any IP address

wheresthatip 8.8.8.8
wheresthatip 1.1.1.1

Output as JSON

wheresthatip --json
wheresthatip 8.8.8.8 --json

{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "state": "California",
  "country": "United States",
  "isp": "Google LLC",
  "latitude": 37.386,
  "longitude": -122.0838
}

Get just the IP (for scripting)

wheresthatip --raw
# 203.0.113.42

# Use in scripts:
MY_IP=$(wheresthatip --raw)

Use as a library

const { myip, lookup } = require('wheresthatip');

// Get your public IP
const ip = await myip();
console.log(ip); // "203.0.113.42"

// Look up any IP
const info = await lookup('8.8.8.8');
console.log(info.country); // "United States"
console.log(info.city);    // "Mountain View"
console.log(info.isp);     // "Google LLC"

API

myip()

Returns a Promise<string> with your public IP address.

lookup(ip)

Returns a Promise<Object> with geolocation data:

| Field | Type | Description | |-------|------|-------------| | ip | string | The IP address | | city | string | City name | | state | string | State/region name | | country | string | Country name | | isp | string | Internet Service Provider | | latitude | number | Latitude coordinate | | longitude | number | Longitude coordinate | | postal | string | Postal/ZIP code |

Options

| Flag | Description | |------|-------------| | -j, --json | Output as JSON | | -r, --raw | Output IP address only | | -h, --help | Show help | | -v, --version | Show version |

Powered by

WheresThatIP.com — Free IP geolocation, network tools, and privacy resources.

• What Is My IP? — See your public IP and location
• IP Lookup — Look up any IP address
• DNS Lookup — Query DNS records
• Ping Test — Test connectivity
• Best VPNs — Protect your IP with a VPN

License

MIT