Overview
The Username Search tool uses Sherlock to hunt down social media accounts and online profiles associated with a specific username across 300+ websites and platforms.Sherlock checks for username presence on platforms including social networks, gaming sites, forums, dating apps, professional networks, and more.
How It Works
The tool executes Sherlock as a subprocess, parses the output to identify matching profiles, and persists results to both session storage and disk for audit trails.Technical Implementation
FromUsernameSearch/views.py:49-82:
Usage
Enter Username
Input the target username in the search form. You can optionally include the
@ prefix - it will be automatically stripped.Validation Rules:- 2-64 characters
- Letters, numbers, dots, underscores, and hyphens allowed
- No special characters or spaces
Execute Search
Click search to begin the Sherlock scan. The process has:
- Per-site timeout: 15 seconds
- Total timeout: 300 seconds (5 minutes)
View Results
Results are displayed in two modes:
- Found Only (default): Shows only platforms where the username exists
- Show All: Displays all checked platforms with status
- Platform name
- Profile URL
- Existence status
- Any errors encountered
Username Validation
FromUsernameSearch/forms.py:21-34:
Result Parsing
Sherlock output is parsed to extract platform matches: FromUsernameSearch/views.py:111-118:
Output Format
Sherlock’s typical output format:[+] markers indicating found profiles.
File Sanitization
FromUsernameSearch/views.py:28-46:
../../../etc/passwd..\\..\\..\\windows\\system32user; rm -rf /
Result Persistence
Results are saved in multiple formats for audit trails and analysis:Storage Location
FromUsernameSearch/views.py:146-168:
File Formats
JSON Format
Text Format
UsernameSearch/views.py:180-212:
Auto-Cleanup
The tool implements automatic cleanup of old result files: FromUsernameSearch/views.py:217-243:
API Endpoints
Defined inUsernameSearch/urls.py:
| Endpoint | View Function | Purpose |
|---|---|---|
/search/ | search_username | Search form and execution |
/results/ | show_results | Display formatted results |
/download/ | download_results | Export results as CSV |
CSV Export
Results can be downloaded in CSV format: FromUsernameSearch/views.py:355-383:
Result Filtering
The results page supports two display modes: FromUsernameSearch/views.py:330-334:
- Default: Only shows platforms where username exists
- Show All: Displays all checked platforms (found and not found)
Sherlock Fallback
If the module execution fails, the tool tries the command-line executable: FromUsernameSearch/views.py:84-107:
Error Detection
The tool detects IP blocking and rate limiting: FromUsernameSearch/views.py:120-128:
Use Cases
Social Media Investigation
- Map an individual’s online presence
- Discover hidden or alternate accounts
- Identify cross-platform patterns
Threat Intelligence
- Track threat actor personas
- Correlate usernames across forums
- Identify infrastructure operators
Brand Monitoring
- Find impersonation accounts
- Track brand mentions across platforms
- Identify unauthorized use of trademarks
Background Checks
- Verify online activity claims
- Discover public profiles
- Assess digital footprint
Cyberbullying Investigation
- Identify harassment accounts
- Track perpetrator activity
- Gather evidence for law enforcement
Supported Platforms
Sherlock checks 300+ platforms including:Social Media
- Instagram, Twitter, Facebook, LinkedIn
- TikTok, Snapchat, Pinterest
- Reddit, Tumblr, Medium
Professional
- GitHub, GitLab, Bitbucket
- Stack Overflow, HackerRank
- Behance, Dribbble, DeviantArt
Gaming
- Steam, Xbox Live, PlayStation Network
- Twitch, Discord (limited)
- Roblox, Minecraft
Dating & Social
- Match.com, OkCupid, POF
- Badoo, Meetup
Forums & Communities
- 4chan, 8chan (archived)
- HackForums, Cracked.to
- Various niche forums
Performance Considerations
- Per-site timeout: 15 seconds
- Total timeout: 300 seconds (5 minutes)
- Concurrent checks: Sherlock handles parallelization internally
- Average duration: 60-120 seconds for full scan
- Rate limiting: Some platforms may block after repeated queries
Search duration varies based on:
- Number of active platforms in Sherlock’s database
- Network latency
- Rate limiting by target sites
- Server response times
Limitations
Privacy & Legal Considerations
Troubleshooting
Sherlock Not Found
If you receive “Sherlock no está instalado” error:Timeout Errors
If searches frequently timeout:- Check network connectivity
- Consider reducing per-site timeout
- Verify no firewall blocking
IP Blocked Message
If you see “IP Bloqueada por varios sitios”:- Wait before retrying (rate limiting)
- Consider using a VPN or proxy
- Reduce search frequency
No Results
If legitimate username returns no results:- Verify username spelling
- Check if platforms have changed their URLs
- Update Sherlock to latest version:
pip install --upgrade sherlock-project
