Frequently Asked Questions

• Ubuntu 20.04+ (tested and recommended)
• Kali Linux (pre-configured for security tools)
• Debian 10+
• Linux Mint 20+

• Fedora 34+
• Arch Linux
• CentOS 8+
• Pop!_OS
• Any distribution with Python 3.8+

# Debian/Ubuntu/Kali
sudo apt install python3 python3-pip

# Fedora
sudo dnf install python3 python3-pip

# Arch
sudo pacman -S python python-pip

1. Install Termux from F-Droid (not Google Play)
2. Update packages:
   pkg update && pkg upgrade
   
3. Install dependencies:
   pkg install python git
   pip install requests phonenumbers
   
4. Grant storage permission (to save results):
   termux-setup-storage
   
5. Clone and run:
   git clone https://github.com/Devsebastian44/IP-Tracker.git
   cd IP-Tracker
   python tracker.py
   

• OS: Linux, macOS, Windows, or Android (via Termux)
• Python: 3.8 or higher
• RAM: 128 MB (minimal)
• Storage: 50 MB (including dependencies)
• Internet: Active connection for API calls

• Python: 3.10+
• RAM: 512 MB+
• Terminal: ANSI color support (for better display)

​

IP Geolocation APIs

• Endpoint: http://ip-api.com/json/{ip}
• Data Provided: Country, region, city, coordinates, ISP, organization, timezone
• Free Tier: 45 requests/minute
• Documentation: ip-api.com/docs

• Endpoint: https://ipinfo.io/{ip}/json
• Data Provided: Country, region, city, coordinates, hostname, organization, timezone
• Free Tier: 50,000 requests/month
• Documentation: ipinfo.io/developers

​

Phone Number Library

• Type: Offline Python library
• Data: Phone format validation, carrier, timezone, number type
• Documentation: github.com/daviddrysdale/python-phonenumbers

​

ip-api.com

• Limit: 45 requests per minute
• Reset: Every minute
• Response: HTTP 429 (Too Many Requests)

​

ipinfo.io

• Limit: 50,000 requests per month
• Reset: Monthly
• Response: Error in JSON response

​

Avoiding Rate Limits

1. Add Delays (for batch processing):
   import time
   time.sleep(2)  # Wait 2 seconds between requests
   
2. Switch APIs: Use Method 2 if Method 1 is rate-limited
3. Cache Results: Don’t query the same IP multiple times
4. Upgrade Plan: Consider paid tiers for heavy usage:
   • ip-api.com: $13/month for 150k requests
   • ipinfo.io: $249/month for 250k requests

​

Typical Accuracy Levels

​

Factors Affecting Accuracy

1. IP Type:
   • ✅ Static IPs: More accurate (businesses, servers)
   • ⚠️ Dynamic IPs: Less accurate (home users, mobile)
2. ISP Database Updates:
   • Accuracy depends on how recently ISPs updated their records
   • Major ISPs update regularly; smaller ones may lag
3. VPN/Proxy Detection:
   • VPNs/proxies show location of VPN server, not user
   • Commercial VPNs often detected in “organization” field
4. Mobile Networks:
   • May show carrier hub location, not actual device location
   • Can vary as user moves between cell towers

​

What You CAN Get:

• Approximate city/region (within 25-50 km)
• Country (highly accurate)
• ISP/Organization
• Timezone

​

What You CANNOT Get:

• Exact street address
• GPS coordinates
• Building/apartment number
• Real-time tracking

​

Legal Alternatives for Accurate Location:

• GPS tracking apps (requires device access)
• Mobile carrier triangulation (requires legal authority)
• Law enforcement warrants

​

Validation Data

• Validity: Is the number format valid?
• Possibility: Could this number exist?
• Formatted Output: International, E.164, and national formats

​

Geographic Information

• Country: Country where number is registered
• Region: General region (if available)
• Timezone: Timezone(s) for that country/region

​

Carrier Information

• Operator: Mobile carrier name (when available)
• Number Type: Mobile, landline, VoIP, toll-free, etc.

​

What You DON’T Get:

• ❌ Owner’s name
• ❌ Current location
• ❌ Call history
• ❌ Social media profiles
• ❌ Email address

​

Save Location

IP-Tracker/
└── Resultados_Tracker/
    ├── IP_8.8.8.8_20250304_143052.txt
    ├── IP_8.8.8.8_metodo2_20250304_143055.txt
    └── Telefono_593991234567_20250304_143128.txt

​

File Naming Convention

• IP Queries: IP_{address}_{timestamp}.txt
• IP Method 2: IP_{address}_metodo2_{timestamp}.txt
• Phone Queries: Telefono_{country_code}{number}_{timestamp}.txt
• Timestamp Format: YYYYMMDD_HHMMSS

​

File Contents

• Query timestamp
• Complete data from the API
• Google Maps link (for IP queries)
• Formatted output

​

By IP-Tracker (Local)

• ✅ Results saved locally in Resultados_Tracker/
• ✅ No cloud upload - everything stays on your device
• ✅ No telemetry - no data sent to developers
• ✅ Open source - verify the code yourself

​

By Third-Party APIs

• ⚠️ ip-api.com: May log queries (check their privacy policy)
• ⚠️ ipinfo.io: Logs API requests (check their privacy policy)

​

Best Practices

1. Don’t query sensitive IPs you don’t own
2. Use VPN if privacy is a concern
3. Delete result files when done
4. Consider self-hosting alternative APIs for maximum privacy

• Your IP address (standard for any web request)
• The IP you’re querying about
• Timestamp of your request
• User agent (Python requests library)

​

If This Concerns You:

1. Use a VPN: Route queries through a VPN server
2. Use Tor: Route through Tor network (slower)
3. Self-Host: Set up your own geolocation database
4. Proxy: Use a proxy server

​

Legal Uses ✅

• Analyzing your own network
• Security research with authorization
• Educational purposes
• Diagnosing network issues
• Fraud detection (with proper authority)

​

Illegal Uses ❌

• Stalking or harassment
• Unauthorized network scanning
• Identity theft
• Violating privacy laws (GDPR, CCPA, etc.)
• Any unauthorized access

​

Jurisdiction Matters

​

1. Use a VPN

# Popular VPN providers:
# - ProtonVPN (free tier available)
# - Mullvad
# - IVPN

​

2. Use Tor Browser

• Download from torproject.org
• Routes traffic through multiple encrypted nodes
• Slower but highly private

​

3. Use Proxy Servers

• Configure system-wide or per-application
• Less secure than VPN but can hide IP

​

4. Use Public Networks Carefully

• Your public WiFi location may be associated with your IP
• Use VPN on public networks

​

5. Request Dynamic IP

• Contact your ISP to use dynamic IPs
• Changes regularly (but still traceable during usage)

​

Method 1 (ip-api.com)

• More detailed information (AS number, more ISP data)
• Faster response times
• No account required

• Lower rate limit (45/minute)
• HTTP only (not HTTPS)

​

Method 2 (ipinfo.io)

• Higher monthly limit (50k/month)
• HTTPS connection
• Includes hostname

• Slightly less detailed
• Requires account for advanced features

​

Recommendation

​

Simple Automation Script

import time
from tracker import geolocalizar_ip_metodo1

ips = ["8.8.8.8", "1.1.1.1", "9.9.9.9"]

for ip in ips:
    print(f"\nQuerying {ip}...")
    geolocalizar_ip_metodo1(ip)
    time.sleep(2)  # Respect rate limits

​

Important Considerations

1. Rate Limits: Add delays between requests (2+ seconds)
2. Error Handling: Check for failures and retry
3. API Terms: Ensure bulk use complies with ToS
4. Caching: Store results to avoid duplicate queries

​

Ways to Contribute

1. Report Bugs: Open issues on GitHub
2. Suggest Features: Request features via GitHub issues
3. Submit Pull Requests: Fix bugs or add features
4. Improve Documentation: Help others understand the tool
5. Share Knowledge: Write tutorials or guides

​

Contributing Code

# Fork the repository on GitHub
git clone https://github.com/YOUR_USERNAME/IP-Tracker.git
cd IP-Tracker

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

# Make changes and commit
git add .
git commit -m "Add: your feature description"

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

​

Immediate Solutions

1. Switch APIs: Try the alternative method (Method 1 ↔ Method 2)
2. Check Status Pages:
   • ip-api.com: status.ip-api.com
   • ipinfo.io: status.ipinfo.io
3. Wait and Retry: Temporary outages usually resolve quickly

​

Long-Term Solutions

1. Add More APIs: Modify tracker.py to support additional services:
   • ipapi.co
   • ipgeolocation.io
   • ipstack.com
2. Self-Host Database: Use MaxMind GeoLite2 (free) or GeoIP2 (paid):
   import geoip2.database
   reader = geoip2.database.Reader('GeoLite2-City.mmdb')
   response = reader.city('8.8.8.8')
   
3. Cache Results: Store recent queries locally to reduce API dependency