Look Up Any Phone Number From Your Terminal: SearchPhone Does the Heavy Lifting

You've got a phone number and you need to know who it belongs to—but you're tired of bouncing between five different websites, copying and pasting the same digits over and over. It's a tedious workflow that kills your momentum, whether you're doing OSINT research, investigating a spam call, or just trying to reconnect with someone. SearchPhone aims to fix that by consolidating phone number lookups into a single terminal command, pulling data from multiple APIs in parallel and handing you a clean report at the end.

What It Does

SearchPhone is a Python-based OSINT tool that runs from your terminal. Give it a phone number and it validates the format, then fires off searches across several sources simultaneously. It hits Google via SerpAPI, DuckDuckGo, GitHub code search, and Reddit, looking for any mentions of that number. It also pulls carrier and location data through the Numverify API, and checks whether the number has been compromised by info-stealer malware using Hudson Rock's Cavalier API—that last one requires no API key at all.

The tool runs on Python 3.8+, and the output is colorful for easy scanning. When it's done, it automatically generates both JSON and PDF reports, so you get a structured record you can save, share, or parse programmatically. The architecture is straightforward: you configure your API keys in a .env file, run one command, and let the parallel processing do its thing.

Why It's Cool

What makes SearchPhone worth a look isn't any single feature—it's the way it bundles several useful capabilities into one workflow.

• Parallel processing actually matters here. Searching five different sources sequentially would turn a quick lookup into a multi-minute wait. Running them simultaneously keeps the whole thing snappy, which is the difference between a tool you use and a tool you avoid.

• The infostealer check is a genuinely thoughtful addition. Most phone lookup tools stop at carrier info and search results. Knowing whether a number has appeared in malware logs is the kind of intelligence that's hard to find elsewhere, and the fact that it's free with no API key required lowers the barrier to entry.

• PDF reports are a practical touch. If you're doing OSINT work for a report, an investigation, or just your own records, having a clean PDF generated automatically saves you from screenshotting terminal output like it's 2005.

• The setup is honest about what it needs. Three API keys is a real requirement—Numverify, SerpAPI, and a GitHub token—but the README spells out exactly where to get each one and what free tier you're working with. That's refreshingly transparent.

• Cross-platform support is verified. Kali Linux, Parrot Security OS, Windows 11, BackBox, and Arch Linux are all listed as tested and working. That's a solid spread for a tool that's clearly aimed at security researchers and pentesters.

How to Try It

Getting started takes a few minutes, most of which is just grabbing API keys. First, clone the repo and install the dependencies:

git clone https://github.com/HackUnderway/SearchPhone.git
cd SearchPhone
pip install -r requirements.txt

Then set up your configuration. The repo includes an example.env file—copy it and fill in your keys:

cp example.env .env

Edit the .env file with your editor of choice, then replace the placeholders:

# Required APIs
NUMVERIFY_KEY=your_numverify_api_key_here
SERPAPI_KEY=your_serpapi_key_here
GITHUB_TOKEN=your_github_token_here

You'll need to grab keys from numverify.com (free tier: 100 requests/month), serpapi.com (free tier: 250 searches/month), and your GitHub settings (free tier: 5,000 requests/hour). The Hudson Rock Cavalier API needs no key, which is one less thing to manage.

Once that's done, just run:

python3 search_phone.py

And you're in business. The full repository is at github.com/HackUnderway/SearchPhone.

Final Thoughts

SearchPhone is a practical tool for anyone who does phone number lookups regularly—security researchers, OSINT enthusiasts, or even just privacy-conscious folks who want to know what's attached to a number. The requirement to set up three API keys is a bit of upfront friction, but the payoff is a unified workflow that produces structured reports without manual effort. It's not trying to be a polished SaaS product; it's a focused utility that does one job well. If you're already comfortable in a terminal and you're tired of tab-hopping for this kind of research, it's worth the ten minutes of setup.

Follow @githubprojects for more developer tools and open source projects.