- Notifications
You must be signed in to change notification settings - Fork4
TeleSpot OSINT lookup from Telephone number using DDGR + BING + GOOGLE + DEHASHED and uses pattern recognition correlations. NOW with TelespotX!
License
thumpersecure/Telespot
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
_ * _ _ * | |_ ___| | ___ ___ _ __ ___ | |_ | __/ _ \ |/ _ \/ __| '_ \ / _ \| __|* | || __/ | __/\__ \ |_) | (_) | |_ \__\___|_|\___||___/ .__/ \___/ \__|* |_| * v5.0-betaTelespot is a powerful Python-based OSINT tool that investigates phone numbers across multiple search engines. It generates format variations and correlates results to surfacenames,locations, andusernames.
Getting Started •Features •Usage •API Setup •Case Study •Support
Get up and running in under 2 minutes:
# 1️⃣ Clone the repositorygit clone https://github.com/thumpersecure/Telespot.gitcd Telespot# 2️⃣ Set up virtual environment (recommended)python3 -m venv telvenvsource telvenv/bin/activate# 3️⃣ Install dependenciespip install -r requirements.txt# 4️⃣ Configure your API keys./telespot.py --setup# 5️⃣ Run your first search!./telespot.py 8885551212
💡Tip: No API keys? No problem! DuckDuckGo works without any setup.
| Feature | Description |
|---|---|
| 🔍4 Search APIs | Google, Bing, DuckDuckGo, and Dehashed (optional) |
| 📱10 Phone Formats | Dashes, digits, parentheses, international, quoted variants |
| 🧠Pattern Analysis | Extracts names, locations, usernames with confidence scoring |
| 🛡️Anti-Detection | User-agent rotation (11 profiles) + random 3-5s delays |
| 🎨Output Options | Verbose, colorful rainbow mode, JSON/TXT export, summary charts |
| 🌍International | Support for country codes worldwide |
| ⚡Fast Mode | TelespotX for parallel requests (US only) |
Needmaximum speed? Usetelespotx.py for parallel requests with no rate limiting:
pip install httpx./telespotx.py 8885551212# ⚡ ~5 seconds vs ~60 seconds| 🐢 telespot.py | ⚡ telespotx.py | |
|---|---|---|
| Speed | ~60s | ~5s |
| Rate limiting | ✅ Yes | ❌ No |
| Formats | 10 | 6 |
| Region | 🌍 International | 🇺🇸 US only |
| Library | requests | httpx |
./telespot.py 8885551212# 🔍 Basic search./telespot.py 8885551212 -v# 📝 Verbose output with URLs./telespot.py 8885551212 --colorful# 🌈 Rainbow color mode./telespot.py 8885551212 -k"name"# 🔑 Add keyword filter./telespot.py 8885551212 -s site.com# 🌐 Search specific site./telespot.py 8885551212 --dehashed# 🔓 Include breach database./telespot.py 8885551212 -o out.json# 💾 Save to JSON./telespot.py +442071234567 -c +44# 🇬🇧 International number
./telespot.py --setup# ⚙️ Configure API keys./telespot.py --api-status# 📊 Check API configuration./telespot.py --update# 🔄 Update from GitHub./telespot.py --help# ❓ Show help
🔍 SEARCH OPTIONS -k, --keyword Add search keyword (e.g., "owner", "business") -s, --site Limit to specific site (e.g., whitepages.com) -c, --country Country code (default: +1) --dehashed Include Dehashed breach database📤 OUTPUT OPTIONS -v, --verbose Show detailed results with URLs -o, --output Save to file (.json or .txt) --summary Show pattern comparison chart --dtmf Show DTMF tone representation🎨 DISPLAY OPTIONS --colorful Enable rainbow color mode --no-color Disable all colors⚙️ CONFIGURATION --setup Interactive API key setup wizard --api-status Show current API configuration --update Update Telespot from GitHub -d, --debug Enable debug outputRun the interactive setup wizard:
./telespot.py --setup
| API | Free Tier | Signup |
|---|---|---|
| 🔵Google Custom Search | 100 searches/day | Get Key |
| 🟢Bing Search (Azure) | 1,000 searches/month | Get Key |
| 🟠DuckDuckGo | ♾️ Unlimited | No key needed! |
| 🔴Dehashed | Paid | Sign Up |
📘Need detailed instructions? SeeGUIDE_APIS.md for step-by-step API setup.
Your API keys are securely stored in~/.telespot_config:
# 🔵 Google Custom Search APIgoogle_api_key=YOUR_GOOGLE_API_KEYgoogle_cse_id=YOUR_CUSTOM_SEARCH_ENGINE_ID# 🟢 Bing Search API (Azure)bing_api_key=YOUR_BING_API_KEY# 🔴 Dehashed API (optional)dehashed_api_key=your_email@example.com:your_api_key
🔒Security: Config file permissions are set to
600(owner read/write only).
📞 Searching for: 8885551212🌍 Country code: +1📊 Using 10 format variations[1/10] Searching: 888-555-1212 → Google API... (8 results) → Bing API... (10 results) → DuckDuckGo... (2 results) ✅ 20 total for this format ⏳ Rate limit: 4.2 seconds══════════════════════════════════════════📊 PATTERN ANALYSIS SUMMARY══════════════════════════════════════════🎯 Confidence Score: HIGH (78%)👤 Names Found: • John Smith: 12x ⭐ • Jane Doe: 3x📍 Locations: • Philadelphia, PA: 15x ⭐ • PA: 10x🔗 Usernames: • @johnsmith: 3x ⭐══════════════════════════════════════════❌ No results found
- Check API status:
./telespot.py --api-status - Verify API keys are valid
- Try with
--debugto see API responses - DuckDuckGo Instant Answers only works for well-known topics
⚠️ API quota exceeded
- Google: 100/day, resets at midnight UTC
- Bing: 1,000/month, resets monthly
- DuckDuckGo: No limits (but limited result types)
🔌 Connection errors
- Check your internet connection
- Use
--debugto see detailed error messages - Some APIs may be temporarily unavailable
Created with ❤️ by:
- Spin (@thumpersecure)
- User-Agent rotation concept from@kaifcodec
This project is licensed under theMIT License - see theLICENSE file for details.
Made with 🔍 for the OSINT community
About
TeleSpot OSINT lookup from Telephone number using DDGR + BING + GOOGLE + DEHASHED and uses pattern recognition correlations. NOW with TelespotX!
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Contributors3
Uh oh!
There was an error while loading.Please reload this page.