User Scanner

User Scanner Logo

Discord

kaifcodec%2Fuser-scanner | Trendshift

A powerful 2-in-1 OSINT suite engineered for deep Email and Username Intelligence.

With 350+ total scan vectors—including 140+ email-integrated sites and 210+ username platforms—you can map digital footprints, analyze target behavior, uncover interests, and verify account registrations in seconds.

The ultimate reconnaissance tool for hunting down targets using just an email or username—now fully integrated with Hudson Rock for instant data breach intelligence.

Sponsored by

WebVetted Sponsor Banner
Go beyond account enumeration. Webvetted turns an email or username into a complete identity investigation with deep OSINT enrichment, breach intel, AI analysis, and an interactive identity graph.
Start an Investigation →

User Scanner Features:

  • ✅ Deep Email & Username OSINT: Look up email registrations and perform advanced username profiling across 350+ platforms.
  • ✅ Profile Data Extraction: Goes beyond basic availability checks to scrape and extract rich metadata, account details, and digital footprints from target profiles.
  • ✅ Dual-Mode Engine: Run targeted email campaigns, massive username sweeps, or simultaneous dual-identifier scans.
  • ✅ Granular Status Reporting: Get crystal-clear results (Registered/Available for emails; Found/Not Found/Error for usernames) backed by precise exception handling.
  • ✅ Modular & Extensible: Built on a highly decoupled, modular architecture, adding new platform modules takes just a few lines of code.
  • ✅ Mass Bulk Scanning: High-throughput processing for bulk lists of usernames and emails via structured input files.
  • ✅ Permutation Generator: Wildcard-based username variation generation to catch typosquatting or alternative aliases.
  • ✅ Multi-Format Export: Clean console output paired with structured, automated exports to JSON and CSV for easy pipeline integration.
  • ✅ Advanced Proxy Rotation: Built-in proxy pivoting with automated rotation and pre-scan health checks to bypass strict rate-limiting.
  • ✅ Smart Auto-Update System: Keeps your signatures and modules fresh with interactive, seamless PyPI update prompts.

Virtual Environment (optional but recommended)

# create venv
python3 -m venv .venv

Activate venv

# Linux / macOS
source .venv/bin/activate

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

Installation

🐍 Via PyPI (Standard Python Setup)

# Upgrade pip to the latest version
python3 -m pip install --upgrade pip

# Install the package globally or in your virtual environment
pip install user-scanner

❄️ Via Nix (Linux & macOS)

# Run the scanner instantly without installing anything permanently
nix run github:kaifcodec/user-scanner/main -- --help

# Drop into a temporary shell where the 'user-scanner' command is active
nix shell github:kaifcodec/user-scanner/main

# (For Developers) Clone the repo and drop into an isolated workspace
nix develop .

Important Flags

See Important flags here and use the tool powerfully

Usage

Basic username/email scan

Scan a single email or username across all available modules/platforms:

user-scanner -e johndoe@gmail.com   # single email scanning 
user-scanner -u johndoe             # single username scanning

Verbose mode

Use -v flag to show the url of the sites being checked

user-scanner -v -e johndoe@gmail.com -c dev

Output:

  ...
  [✔] Huggingface [https://huggingface.co] (johndoe@gmail.com): Registered
  [✔] Envato [https://account.envato.com] (johndoe@gmail.com): Registered
  [✔] Replit [https://replit.com] (johndoe@gmail.com): Registered
  [✔] Xda [https://xda-developers.com] (johndoe@gmail.com): Registered
  ...

Selective scanning

Scan only specific categories or single modules:

user-scanner -u johndoe -c dev                # developer platforms only
user-scanner -e johndoe@gmail.com -m github   # only GitHub

Bulk email/username scanning

Scan multiple emails/usernames from a file (one email/username per line):

  • Can also be combined with categories or modules using -c , -m and other flags
user-scanner -ef emails.txt     # bulk email scan
user-scanner -uf usernames.txt  # bulk username scan

Pattern generation

See Pattern Syntax for more details

Library mode for email_scan

Only available for user-scanner>=1.2.0

See full usage (eg. category checks, full scan) guide library usage

  • Email scan example (single module):
import asyncio
from user_scanner.core import engine
from user_scanner.email_scan.shopping import etsy

async def main():
    # Engine detects 'email_scan' path -> returns "Registered" status
    result = await engine.check(etsy, "test@gmail.com")
    json_data = result.to_json() # returns JSON output
    csv_data = result.to_csv()   # returns CSV output
    print(json_data)             # prints the json data

asyncio.run(main())

Output:

{
  "email": "test@gmail.com",
  "category": "Shopping",
  "site_name": "Etsy",
  "status": "Registered",
  "url": "https://www.etsy.com",
  "extra": {
    "id": 98832,
    "name": "test123",
    "username": "test123",
    "gender": "private",
    "is_seller": "No",
    "has_public_page": "No",
    "stats": "0 followers | 0 following | 0 favorites",
    "privacy": "Items are Public | Shops are Public",
    "joined": "2010-09-19 05:04:06",
    "last_profile_update": "2020-07-31 01:40:24",
    "avatar": "https://i.etsystatic.com/site-assets/images/avatars/default_avatar.png?width=400"
  },
  "reason": ""
}

Using Proxies

Validate proxies before scanning (tests each proxy against google.com):

user-scanner -u johndoe -P proxies.txt --validate-proxies # recommended

This will:

  1. Filter out non-working proxies
  2. Save working proxies to validated_proxies.txt
  3. Use only validated proxies for scanning

💖 Support the project

Web platforms constantly update their authentication flows, meaning keeping over 300 modules running smoothly requires a relentless, around-the-clock commitment to maintaining code. What started as a passion project has evolved into a demanding, highly technical undertaking to ensure the tool remains reliable for the community.

While commercial threat intelligence platforms often charge thousands of dollars for these exact capabilities, user-scanner remains completely free and open-source.

​If this tool just saved you hours of manual pivoting, helped you score a bug bounty, or secured your company's footprint, consider supporting this project. Keep OSINT powerful, open, and free.

GitHub Sponsor

Sponsors

Huge thanks to our amazing sponsors who support the development of user-scanner!

soxoj
@soxoj 		heynimba
@hienyimba 		heynimba
@InDieTasten

Screenshots:

Note: Screenshots might be outdated

1000188339

user-scanner_u_usage.webm

  • Use the --hudson flag to check if a username or email has been exposed in infostealer malware logs.
user-scanner -e johndoe@gmail.com --hudson   # for email check
user-scanner -u johndoe --hudson             # for username check
1000183041

Contributing

See detailed Contributing guidelines

⚠️ Disclaimer

This tool is provided strictly for educational purposes, authorized security research, and defensive OSINT investigations.

  • User Responsibility: The user assumes all responsibility for ensuring that their deployment and use of this software complies with all applicable local, national, and international laws, as well as the Terms of Service (ToS) of any scanned platforms.
  • Data Source & Methodology: This tool acts exclusively as an aggregator of publicly accessible information and legitimate third-party threat intelligence APIs. It does not bypass authentication mechanisms, exploit security vulnerabilities, or access non-public private data.
  • Information Aggregation: While this software extracts public metadata and references external breach intelligence feeds (e.g., Hudson Rock), the developers do not host, store, or maintain any underlying personal data. All data is processed locally on the user's machine in real-time.
  • Limitation of Liability: This software is provided "as is", without warranty of any kind, express or implied. The developers accept no liability and are not responsible for any misuse, unintended consequences, damage, or legal actions resulting from the use of this tool.

🛠️ Troubleshooting

Some sites may return 403 Forbidden or connection timeout errors, especially if they are blocked in your region (this is common with some adult sites).

  • If a site is blocked in your region, use a VPN and select a region where you know the site is accessible.
  • Then run the tool again.

These issues are caused by regional or network restrictions, not by the tool itself. If it still fails, report the error by opening an issue.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.5.0.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kaifcodec from gravatar.com kaifcodec

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Kaif

Requires

Python >=3.10

Provides Extra

dev

Tags

osint email-osint username-osint python cli-tool cybersecurity threat-intelligence security

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

user_scanner-1.4.1.8.tar.gz (161.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

user_scanner-1.4.1.8-py3-none-any.whl (376.3 kB view details)

Uploaded Python 3

File details

Details for the file user_scanner-1.4.1.8.tar.gz.

File metadata

  • Download URL: user_scanner-1.4.1.8.tar.gz
  • Upload date:
  • Size: 161.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.33.1

File hashes

Hashes for user_scanner-1.4.1.8.tar.gz
Algorithm Hash digest
SHA256 fd797a5835e26f52336c8e6ed0d41adaec545eb8a81b60850cce3bdf81507928
MD5 37f040527a7f46f7c603ee91c0a0847e
BLAKE2b-256 5a710e922f1c3a5093ff43c2e5b2bf24dae72d54c034a7da2f0d5816557b06b0

See more details on using hashes here.

File details

Details for the file user_scanner-1.4.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for user_scanner-1.4.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 0d421af1d482df36a47acf6d2ddec65a929bb40dbd0c9595bd6b3ec2fb4d5289
MD5 f2c7aac3685b7a2a18100506f4f744cb
BLAKE2b-256 b96770b12384b3c22ac8f6c26926d1184b136f8cecf8b9acbe2acf93510f4563

See more details on using hashes here.

Release history Release notifications | RSS feed

1.5.0.1

2 files

1.5.0

2 files

1.4.3.1

2 files

Yanked

1.4.3

2 files

Yanked reason: v1.4.3 contains a data-loss bug ignoring the media dictionary in result rendering and export pipelines. Use v1.4.3.1 or higher.

1.4.2.1

2 files

1.4.2

2 files

1.4.1.9

2 files

This release

1.4.1.8 This release

2 files

1.4.1.7

2 files

1.4.1.6

2 files

1.4.1.5

2 files

1.4.1.4

2 files

1.4.1.3

2 files

1.4.1.2

2 files

1.4.1.1

2 files

1.4.1

2 files

1.4.0.3

2 files

1.4.0.2

2 files

1.4.0.1

2 files

1.4.0

2 files

1.3.6.8

2 files

1.3.6.7

2 files

1.3.6.6

2 files

1.3.6.5

2 files

1.3.6.4

2 files

1.3.6.3

2 files

1.3.6.2

2 files

1.3.6.1

2 files

1.3.6

2 files

1.3.5.9

2 files

1.3.5.8

2 files

1.3.5.7

2 files

1.3.5.6

2 files

1.3.5.5

2 files

1.3.5.4

2 files

1.3.5.3

2 files

1.3.5.2

2 files

1.3.5.1

2 files

1.3.5

2 files

1.3.4.6

2 files

1.3.4.5

2 files

1.3.4.4

2 files

1.3.4.3

2 files

1.3.4.2

2 files

1.3.4.1

2 files

1.3.4

2 files

1.3.3.3

2 files

1.3.3.2

2 files

1.3.3.1

2 files

1.3.3

2 files

1.3.2.2

2 files

1.3.2.1

2 files

1.3.2

2 files

1.3.1.1

2 files

1.3.1

2 files

1.3.0.3

2 files

1.3.0.2

2 files

1.3.0.1

2 files

1.3.0

2 files

1.2.0.6

2 files

1.2.0.5

2 files

1.2.0.4

2 files

1.2.0.3

2 files

1.2.0.2

2 files

1.2.0.1

2 files

1.2.0

2 files

1.1.1.2

2 files

1.1.1.1

2 files

1.1.1.0

2 files

1.1.0.9

2 files

1.1.0.8

2 files

1.1.0.7

2 files

1.1.0.6

2 files

Yanked

1.1.0.5

2 files

Yanked reason: structure mismatch with standard rules

Yanked

1.1.0.4

2 files

Yanked reason: version mismatch with 1.1.0.2

Yanked

1.1.0.3

2 files

Yanked reason: version mismatch

1.1.0.2

2 files

1.1.0.1

2 files

1.1.0

2 files

1.0.10.3

2 files

1.0.10.2

2 files

1.0.10.1

2 files

1.0.10.0

2 files

1.0.9.1

2 files

1.0.9.0

2 files

1.0.8.1

2 files

1.0.8.0

2 files

1.0.7.0

2 files

1.0.6.0

2 files

1.0.5.0

2 files

1.0.4.2

2 files

1.0.4.1

2 files

1.0.4.0

2 files

1.0.3.1

2 files

1.0.3.0

2 files

1.0.2.1

2 files

1.0.2.0

2 files

1.0.1.6

2 files

1.0.1.5

2 files

1.0.1.4

2 files

1.0.1.3

2 files

1.0.1.2

2 files

1.0.1.1

2 files

1.0.1.0

2 files

1.0.0.9

2 files

1.0.0.8

2 files

1.0.0.7

2 files

1.0.0.6

2 files

1.0.0.5

2 files

1.0.0.4

2 files

1.0.0.3

2 files

1.0.0.2

2 files

1.0.0.1

2 files

1.0.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page