Skip to content
ipwho

Getting Started

ipwho is a command-line tool that looks up geolocation data for any IP address using free public APIs. It supports multiple providers, lets you compare results side-by-side, and outputs clean JSON for scripting.

Quick Install

Section titled “Quick Install”

The fastest way to get started is via npm:

Terminal window
npm install -g ipwho

Or run it directly without installing:

Terminal window
npx ipwho 8.8.8.8

For other install methods (Bash script, PowerShell), see the Installation page.

Your First Lookup

Section titled “Your First Lookup”

Run ipwho with no arguments to look up your own public IP:

Terminal window
ipwho
Fetching your public IP...
Your IP: 203.0.113.42


[ipinfo]
  IP         203.0.113.42
  City       Sydney
  Region     New South Wales
  Country    AU
  Org        AS12345 Example ISP
  Location   -33.8688,151.2093
  Timezone   Australia/Sydney

Or pass a specific IP:

Terminal window
ipwho 8.8.8.8

Compare Providers

Section titled “Compare Providers”

Use -c to see how different providers report the same IP:

Terminal window
ipwho -c 1.1.1.1

This queries all three providers and shows results side-by-side — useful for verifying accuracy.

What’s Next?

Section titled “What’s Next?”