• Overview
• Features
• Installation
• Quick Start
• Usage
• Command-Line Arguments
• Examples
• API Integration
• Export Formats
• Screenshots
• Troubleshooting
• Performance
• Security
• Contributing
• License

Ultimate IP Lookup is a professional-grade command-line tool that provides comprehensive intelligence about any IP address. Whether you're a security researcher, network administrator, DevOps engineer, or just curious about your public IP, this tool aggregates data from multiple sources to give you the complete picture.

• 🚀 Fast: Concurrent API requests complete in ~1-2 seconds
• 🎨 Beautiful: Rich terminal UI with colors, tables, and progress indicators
• 🔒 Secure: Built-in threat analysis with AbuseIPDB integration
• 🌍 Comprehensive: Aggregates data from 4+ intelligence sources
• 🛠️ Powerful: Includes port scanning, ping tests, and reverse DNS
• 📊 Flexible: Export to JSON or CSV for further analysis
• 💻 Professional: Production-ready code with robust error handling

• Multi-source Data Aggregation: Combines data from ip-api.com, ipinfo.io, ipwhois.app, and more
• Geolocation: Country, region, city, ZIP code, timezone, and GPS coordinates
• Network Information: ISP, organization, AS number, and hosting detection
• Reverse DNS Lookup: Automatic hostname resolution
• Mobile/Proxy Detection: Identifies mobile networks and proxy services

• Threat Intelligence: Integration with AbuseIPDB for real-time abuse scoring
• Risk Assessment: Color-coded threat levels (Low/Medium/High)
• Abuse Reports: View total reports and confidence scores
• Whitelist Status: Check if IP is whitelisted

• Port Scanner: Scan common ports (FTP, SSH, HTTP, HTTPS, MySQL, RDP, etc.)
• Ping Test: HTTP-based connectivity testing with latency metrics
• Service Detection: Identify services running on open ports
• Connection Statistics: Min/max/average latency measurements

• Stunning ASCII Banner: Eye-catching startup display
• Rich Terminal Formatting: Colors, panels, tables, and trees
• Progress Indicators: Real-time spinners for async operations
• Graceful Fallback: Plain text mode when rich library unavailable
• Responsive Design: Adapts to terminal width

• JSON Export: Full structured data for programmatic access
• CSV Export: Spreadsheet-compatible format for analysis
• Auto-naming: Timestamped filenames for easy organization
• Custom Paths: Specify your own output locations

• Concurrent Execution: Parallel API requests using ThreadPoolExecutor
• Smart Fallbacks: Multiple IP detection sources for reliability
• Configurable Timeouts: Adjust for slow connections
• Session Reuse: Efficient HTTP connection pooling

• Python 3.7 or higher
• pip package manager

# Clone the repository
git clone https://github.com/rootpom/ip-checker.git
cd ultimate-ip-lookup

# Install required dependencies
pip install requests

# For enhanced UI (highly recommended)
pip install rich

pip install ultimate-ip-lookup

docker build -t ip-lookup .
docker run -it ip-lookup 8.8.8.8

python ip_lookup.py

python ip_lookup.py 8.8.8.8

python ip_lookup.py 1.1.1.1 --ports --ping --abuse-key YOUR_API_KEY --export json

That's it! You're ready to start gathering IP intelligence.

python ip_lookup.py [IP_ADDRESS] [OPTIONS]

If no IP address is provided, the tool automatically detects and analyzes your public IP.

Check information about Google's DNS server:

python ip_lookup.py 8.8.8.8

Output:

╔═══════════════════════════════════════════════════════════════╗
║                    IP LOOKUP TOOL v2.0.0                      ║
╚═══════════════════════════════════════════════════════════════╝

✓ Your Public IP: 8.8.8.8

📍 Location
  Country: United States (US)
  City: Mountain View
  ISP: Google LLC

Check if an IP has abuse reports:

python ip_lookup.py 203.0.113.0 --abuse-key YOUR_API_KEY

Output:

🔒 Security Analysis
━━━━━━━━━━━━━━━━━━━━
HIGH RISK ⚠️

Abuse Confidence Score: 85%
Total Reports: 42
Last Reported: 2025-10-01

Complete analysis with port scan and ping test:

python ip_lookup.py 1.1.1.1 --ports --ping

Output:

🔍 Port Scan Results
┌──────┬───────────┬────────┐
│ Port │ Service   │ Status │
├──────┼───────────┼────────┤
│ 80   │ HTTP      │ OPEN   │
│ 443  │ HTTPS     │ OPEN   │
│ 22   │ SSH       │ CLOSED │
└──────┴───────────┴────────┘

📡 Connectivity Test
Packets: Sent = 4, Received = 4, Lost = 0
Minimum = 12.45ms
Average = 14.23ms
Maximum = 16.78ms

Save results for later analysis:

python ip_lookup.py 8.8.8.8 --export json --output google_dns.json

Create a script to analyze multiple IPs:

#!/bin/bash
for ip in 8.8.8.8 1.1.1.1 9.9.9.9; do
    python ip_lookup.py $ip --export json --output "analysis_${ip}.json"
done

Perfect for scripts and cron jobs:

python ip_lookup.py --no-banner --export csv -o /var/log/ip_check.csv

Troubleshoot connection issues:

python ip_lookup.py 203.0.113.1 --verbose --timeout 30

python ip_lookup.py --ports --ping --abuse-key YOUR_KEY --export json

Why? Get real-time abuse reports and threat intelligence.

How to Get:

1. Visit AbuseIPDB
2. Create a free account
3. Go to your account settings
4. Generate an API key
5. Free tier includes 1,000 checks per day

Usage:

python ip_lookup.py 203.0.113.0 --abuse-key YOUR_API_KEY_HERE

Pro Tip: Store your key in an environment variable:

export ABUSE_API_KEY="your_key_here"
python ip_lookup.py 8.8.8.8 -a $ABUSE_API_KEY

Perfect for programmatic access and integration with other tools.

{
  "ip": "8.8.8.8",
  "timestamp": "2025-10-02T10:30:00",
  "ip_api": {
    "country": "United States",
    "city": "Mountain View",
    "isp": "Google LLC",
    "lat": 37.4056,
    "lon": -122.0775
  },
  "reverse_dns": "dns.google",
  "abuse_ipdb": {
    "abuseConfidenceScore": 0,
    "totalReports": 0
  }
}

Great for Excel, Google Sheets, and data analysis.

Field,Value
IP,8.8.8.8
Hostname,dns.google
Country,United States
City,Mountain View
ISP,Google LLC
Latitude,37.4056
Longitude,-122.0775

╔═══════════════════════════════════════════════════════════════╗
║   ██╗██████╗     ██╗      ██████╗  ██████╗ ██╗  ██╗██╗   ██╗██████╗  ║
║   ██║██╔══██╗    ██║     ██╔═══██╗██╔═══██╗██║ ██╔╝██║   ██║██╔══██╗ ║
║   ██║██████╔╝    ██║     ██║   ██║██║   ██║█████╔╝ ██║   ██║██████╔╝ ║
║   ██║██╔═══╝     ██║     ██║   ██║██║   ██║██╔═██╗ ██║   ██║██╔═══╝  ║
║   ██║██║         ███████╗╚██████╔╝╚██████╔╝██║  ██╗╚██████╔╝██║      ║
║   ╚═╝╚═╝         ╚══════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝      ║
║                                                               ║
║              Ultimate IP Intelligence & Analysis              ║
║                        v2.0.0 - 2025                         ║
╚═══════════════════════════════════════════════════════════════╝

╭─────────── 🔒 Security Analysis ────────────╮
│                                             │
│ HIGH RISK ⚠️                                │
│                                             │
│ Abuse Confidence Score: 89%                 │
│ Total Reports: 156                          │
│ Whitelisted: False                          │
│ Last Reported: 2025-10-01T15:30:00         │
│                                             │
╰─────────────────────────────────────────────╯

Solution:

pip install rich

Or run without rich (plain text mode will be used automatically).

Solutions:

1. Check your internet connection
2. Increase timeout: --timeout 30
3. Use verbose mode to see which sources failed: -v

Solutions:

1. Wait a few minutes before retrying
2. Use your own API keys for higher limits
3. Reduce frequency of requests

Possible causes:

• Firewall blocking outbound connections
• Target IP is behind a firewall
• Scanning from restricted network (corporate/school)

Solution:

# Try with increased timeout
python ip_lookup.py 8.8.8.8 --ports --timeout 20

Solutions:

# Increase timeout to 30 seconds
python ip_lookup.py 8.8.8.8 --timeout 30

# Use verbose mode to identify slow sources
python ip_lookup.py 8.8.8.8 -v

Solution: Ensure you're using a valid IPv4 address format: xxx.xxx.xxx.xxx

1. Use Session Reuse: Already implemented (persistent connections)
2. Adjust Timeout: Lower for faster results, higher for reliability
3. Selective Features: Skip --ports and --ping for basic lookups
4. Concurrent Requests: Already optimized with ThreadPoolExecutor

• No data is stored or logged by this tool
• All API calls are made directly to public services
• Export files are stored locally only

• Store API keys in environment variables, not in code
• Never commit API keys to version control
• Use .env files with .gitignore

• Don't scan IPs you don't own or have permission to scan
• Respect API rate limits
• Use for legitimate security research and network administration only

We welcome contributions! Here's how you can help:

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit pull requests
• ⭐ Star the repository

# Fork and clone the repository
git clone https://github.com/rootpom/ip-checker.git
cd ultimate-ip-lookup

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run tests
python -m pytest tests/

# Create a branch for your feature
git checkout -b feature/amazing-feature

# Make your changes and commit
git commit -m "Add amazing feature"

# Push and create a pull request
git push origin feature/amazing-feature

• Follow PEP 8 guidelines
• Use type hints
• Add docstrings to functions
• Keep functions focused and small
• Write descriptive commit messages

• IPv6 support
• Historical data tracking
• Interactive mode with menu system
• Custom configuration file support
• Webhook notifications
• Docker container
• Web dashboard
• Shodan API integration
• VirusTotal integration
• BGP route analysis

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2025 Your Name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

• ip-api.com - Geolocation data
• ipinfo.io - Network information
• ipwhois.app - WHOIS data
• AbuseIPDB - Threat intelligence
• Rich - Beautiful terminal formatting
• All contributors and users of this tool

• 📖 Documentation
• 💬 Discussions
• 🐛 Issue Tracker
• 📧 Email: support@yourdomain.com

• ⭐ Star this repository
• 👀 Watch for updates
• 🐦 Follow us on Twitter: @yourhandle