📡 A powerful Python tool for gathering comprehensive information about phone numbers using multiple APIs and data sources.
📱 Click/tap to view screenshot
| Feature | Description |
|---|---|
| ✅ Phone Number Validation | Verify if a number is valid and properly formatted |
| 📱 Carrier Lookup | Identify the service provider for any phone number |
| 🌍 Geolocation | Determine the country and region associated with a number |
| ⏰ Timezone Detection | Find the timezone(s) for a phone number |
| 📂 Batch Processing | Read multiple numbers from a file (-f) |
| 🔌 API Integration | Supports NumVerify and AbstractAPI (optional) |
| 📊 Multiple Output Formats | Colorful console output and JSON export |
| 🐞 Verbose Mode | Detailed debug output with -v |
| 🎨 No‑Color Option | Disable colored output for scripting (--no-color) |
| 🔒 Privacy Focused | Only uses publicly available information |
# Clone the repository
git clone https://github.com/Anon4You/NumInfo.git
cd NumInfo
# Install dependencies
pip install -r requirements.txt
# (Optional) Set up environment variables for API features
cp .env.example .env
# Edit .env with your API keyspython numinfo.py +1234567890python numinfo.py -f numbers.txtpython numinfo.py +1234567890 -o results.jsonpython numinfo.py +1234567890 -vpython numinfo.py +1234567890 --no-colorpositional arguments:
phone_number Phone number(s) to investigate (include country code)
optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE File containing phone numbers (one per line)
-o OUTPUT, --output OUTPUT
Output file name (JSON format)
-v, --verbose Enable verbose debug output
--no-color Disable colored output
For enhanced features, obtain API keys from:
| API | Purpose | Link |
|---|---|---|
| NumVerify | Carrier details | Get API Key |
| AbstractAPI | Geolocation | Get API Key |
Add your keys to the .env file:
NUMVERIFY_API_KEY=your_key_here
ABSTRACT_API_KEY=your_key_hereDistributed under the MIT License. See LICENSE for more information.
Made with ❤️ by Anon4You
