TokIntel 👁

Advanced TikTok OSINT Framework to extract profiles, bios, creation dates, and full metadata from TikTok usernames 🕵🏽‍♂️

---

#🚀 Features

• 🔎 Profile Reconnaissance: Extracts full TikTok profile data from usernames.
• 📊 Rich Metadata Extraction: Recovers creation dates, bios, full metrics (followers, likes, videos, friends, etc.), and high-res avatars.
• ⚡ Fast API-Based Checking: Powered by Apify's TikTok Profile Scraper.
• 📄 JSON and TXT Report Generation: Automatically saves all structured results locally.
• 🎨 Colored CLI Interface: Clean, aesthetic, and professional terminal output.
• 🔐 Secure API Key Handling: Credentials strictly managed via .env.
• 📂 Batch Processing: Scan lists of targets via TXT file.
• 💡 Automatic API Setup: Interactive onboarding on the first run.

#📌 Prerequisites

• Python 3.8+
• Dependencies: apify-client, python-dotenv, colorama, alive-progress

#🔑 API Key (Apify)

TokIntel uses the following API:

#Steps:

1. Go to Apify and create a free account.
2. Get your API Token from your Apify account settings.
3. Copy your API Token.

#⚙️ Configuration

The first time you run the tool, it will ask for your API key:

python3 TokIntel.py

Your key will be automatically saved in:

.env

You can update it anytime:

python3 TokIntel.py --set-api

---

#💻 Usage

#🔹 Single target

python3 TokIntel.py --user jeyzetaoficial

python3 TokIntel.py --user jeyzetaoficial --show-avatar

python3 TokIntel.py --users-file targets.txt

targets.txt should contain one username per line (without @).

python3 TokIntel.py -h

---

#📁 Reports

All results are saved in the /reports/ directory.

Example file: reports/report_user_20260716_125859_u2943t.json

[!TIP] Note: Check the generated JSON report for advanced profile metadata not displayed in the terminal.

---

#📦 Installation

git clone https://github.com/HackUnderway/TokIntel.git

cd TokIntel

pip install -r requirements.txt

[!WARNING]

#Disclaimer

This tool is intended for educational and OSINT research purposes only.

• Do not use for illegal activities.
• The developer is not responsible for any misuse or damage caused by this tool.

---

#🧠 Notes

• Phone lookups may be unreliable due to API limitations
• Results depend on external data sources
• A "MISS" does not guarantee the account does not exist

The project is open to collaborators and partners.

#🧪 Supported Systems

#Support

For questions, bug reports, or suggestions, please contact: info@hackunderway.com

#License

• TokIntel is licensed.
• See the LICENSE file for more information.

#👨‍💻 Author

• Victor Bancayan - (CEO at Hack Underway)

#🔗 Links

#💰 Bitcoin Donations

Support the project with Bitcoin:

#Address:

bc1qjd5pu8kmdqljun3qyw5e9mj4kdef9n8sutj7j4

Thank you for your support! 🙏

#☕️ Support the project

If you like this tool, consider buying me a coffee:

#🌞 Subscriptions

#Subscribe to: Jey Zeta

from Peru, made in with by: Victor Bancayan

© 2026