🌐 IP Info Extractor

Powerful IP intelligence at your fingertips — straight from the terminal.

---

✨ Features

Feature	Details
🔍 Single & Batch Lookups	Look up one IP or hundreds at once
🏠 Own-IP Detection	Run with no arguments to discover your own public IP
🌈 Rich Coloured Tables	Beautiful terminal output powered by Rich
📄 Multiple Output Formats	table (default), json, or csv
💾 Save to File	Write results to any file with --output
🛡️ Proxy / VPN / Hosting Flags	Instantly know if an IP belongs to a VPN, proxy, or data-centre
📡 Reverse DNS	PTR record lookup for every IP
✅ Input Validation	Invalid IPs are skipped gracefully with a clear error
📂 Input File Support	Read IPs from a file via --input-file
🔁 Retry + Timeout Controls	Tune network behavior with --retries and --timeout
⏱️ Timeout Handling	Never hangs — all requests have a configurable timeout

---

🚀 Quick Start

Prerequisites

python --version   # Python 3.8+
pip --version

Install dependencies

pip install -r requirements.txt

Make the script executable (optional)

chmod +x ip_info_extractor.py

---

📖 Usage

usage: ip_info_extractor.py [-h] [--input-file FILE] [--format {table,json,csv}] [--output FILE] [--timeout TIMEOUT] [--retries RETRIES] [--no-color] [IP ...]

🌐 IP Info Extractor – Powerful IP intelligence at your fingertips

positional arguments:
  IP                    IP address(es) to look up (omit to detect your own public IP)

options:
  -h, --help            show this help message and exit
  --input-file/-i FILE  Read IP address(es) from FILE (one per line or comma-separated)
  --format/-f {table,json,csv}
                        Output format (default: table)
  --output, -o FILE     Save output to FILE instead of printing to stdout
  --timeout TIMEOUT     Request timeout in seconds (default: 10.0)
  --retries RETRIES     Request retries on failure (default: 2)
  --no-color            Disable coloured output

---

💡 Examples

Look up your own public IP

python3 ip_info_extractor.py

Single IP lookup

python3 ip_info_extractor.py 8.8.8.8

╭─────────────────────────────────────────────────────╮
│       IP Intelligence Report  •  8.8.8.8            │
├────────────────────┬────────────────────────────────┤
│ Field              │ Value                          │
├────────────────────┼────────────────────────────────┤
│ IP Address         │ 8.8.8.8                        │
│ Country            │ United States                  │
│ Country Code       │ US                             │
│ Region             │ California                     │
│ City               │ Mountain View                  │
│ ZIP                │ 94043                          │
│ Latitude           │ 37.422                         │
│ Longitude          │ -122.0841                      │
│ ISP                │ Google LLC                     │
│ Organization       │ Google LLC                     │
│ AS Number          │ AS15169 Google LLC             │
│ Timezone           │ America/Los_Angeles            │
│ Mobile Network     │ No                             │
│ Proxy / VPN        │ No                             │
│ Hosting / DC       │ Yes                            │
│ Reverse DNS        │ dns.google                     │
╰────────────────────┴────────────────────────────────╯

Batch lookup (multiple IPs)

python3 ip_info_extractor.py 8.8.8.8 1.1.1.1 9.9.9.9

Load IPs from a file

python3 ip_info_extractor.py --input-file ips.txt

ips.txt can contain one IP per line or comma-separated values.

JSON output

python3 ip_info_extractor.py 8.8.8.8 --format json

{
    "query": "8.8.8.8",
    "country": "United States",
    "countryCode": "US",
    "regionName": "California",
    "city": "Mountain View",
    "zip": "94043",
    "lat": 37.422,
    "lon": -122.0841,
    "isp": "Google LLC",
    "org": "Google LLC",
    "as": "AS15169 Google LLC",
    "timezone": "America/Los_Angeles",
    "mobile": "No",
    "proxy": "No",
    "hosting": "Yes",
    "rdns": "dns.google"
}

CSV output

python3 ip_info_extractor.py 8.8.8.8 1.1.1.1 --format csv

Save results to a file

python3 ip_info_extractor.py 8.8.8.8 --format json --output result.json
python3 ip_info_extractor.py 8.8.8.8 1.1.1.1 --format csv  --output results.csv

Plain output (no colour, useful for piping)

python3 ip_info_extractor.py 8.8.8.8 --format json --no-color | jq .

Tune request reliability

python3 ip_info_extractor.py 8.8.8.8 --timeout 5 --retries 3

---

🗂️ Repository Structure

ip-tool/
├── ip_info_extractor.py   # Main tool
├── requirements.txt       # Python dependencies
└── README.md              # This file

---

🔌 API

This tool uses the free tier of ip-api.com.

Note: The free tier is limited to 45 requests/minute. For higher throughput, see the ip-api.com Pro plan.

---

📦 Dependencies

Package	Purpose
requests	HTTP client
rich	Coloured terminal output

---

📄 License

This project is released under the MIT License — do whatever you like with it.