README.md
October 16, 2025 Β· View on GitHub
WHATS OSINT π΅οΈββοΈ
OSINT tool for WhatsApp that allows you to obtain profile photos, verify Business accounts, check status and user information, analyze linked devices, review privacy settings, and access full data using the WhatsApp OSINT API from RapidAPI.
Supports 6 endpoints: about, base64, business, devices, doublecheck, privacy.
π Features
- Retrieve WhatsApp profile photos via phone number
- Verify WhatsApp Business accounts
- Check user status and basic info
- Analyze linked devices
- Full OSINT information retrieval
- View privacy settings
- Automatic validation of phone number formats
- Supports international numbers (with country code)
- Interactive terminal interface with colors and menus
- Auto-save images in JPG format
- Detect hidden or missing profile pictures
π Requirements
- Python 3.8+
- Libraries:
requests,python-dotenv,colorama
π API Key (RapidAPI)
| NAME | KEY |
|---|---|
| Whatsapp OSINT | π (Required) |
- Choose a plan β Basic
- Copy your API Key
- Rename the
.env.examplefile to.env - Add your API Key inside the
.envfile
π οΈ Step 1: Configure your API in the .env file
In your project root, run:
cp .env.example .env
πΉ This creates a new .env file with the same content as .env.example.
πΉ .env.example remains untouched (serves as a template).
π οΈ Step 2: Open the .env file for editing
Use nano (or any editor you prefer, such as vim or VS Code):
nano .env
π οΈ Step 3: Edit the variables
Inside nano youβll see something like:
RAPIDAPI_KEY=your_api_key_here
π Replace it with your actual key, for example:
RAPIDAPI_KEY=yysnssksls536m3mdlldldmdddlld
π οΈ Step 4: Save the changes in nano
- Press Ctrl + O β βWrite Outβ (save)
- Confirm the filename
.envβ press Enter - Exit editor with Ctrl + X
π οΈ Step 5: Verify itβs saved
cat .env
β οΈ Usage Warning
This tool is created only for:
- Legitimate cybersecurity investigations
- Authorized security audits
- Educational OSINT projects
- Analysis with explicit consent
π΄ Do NOT use this tool for illegal activity, harassment, or without consent. π’ The author is not responsible for any misuse.
βοΈ Installation
Clone the repository:
git clone https://github.com/kinghacker0/whatsapp-osint
cd whatsapp-osint
python3 -m venv myvenv
source myvenv/bin/activate
pip3 install -r requirements.txt
π Basic Usage
Run the script:
python3 whatsapp-osint.py
- Choose an option from the menu (1β6)
- Enter the phone number including country code (e.g. 51987654321)
- The tool validates the number format and performs the lookup
- Results are displayed according to the selected query type
The project is open for contributors.
π» Supported Distributions
| Distribution | Verified Version | Supported? | Status |
|---|---|---|---|
| Kali Linux | 2025.2 | β | Working |
| Parrot Security OS | 6.3 | β | Working |
| Windows | 11 | β | Working |
| BackBox | 9 | β | Working |
| Arch Linux | 2024.12.01 | β | Working |
π¬ Support & Credit
Thanks & Credit to β HackUnderway