# iojw/socialscan

Python library for accurately querying username and email usage on online platforms

Repository: https://github.com/iojw/socialscan
Canonical: https://ross.abutalabs.com/products/socialscan
Language: Python
License: MPL-2.0
License Family: copyleft
Topics: username, username-checker, cli, social-media, osint, email, email-checker
Last push: 2026-08-03T20:47:15+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 8, longevity 100
- inputs: {"age_days": 2754, "days_push": 30, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1826, forks 219 (observed 2026-08-28T04:05:41.388718+00:00)

## What it is
socialscan is a Python library and CLI tool that checks whether usernames and email addresses are taken, available, or invalid across online platforms like Instagram, Twitter, GitHub, and Reddit. It uses asyncio with aiohttp to run concurrent queries, delivering accurate results without the false positives common in similar tools.

## Use cases
- check if a username is taken on instagram or twitter
- find out if an email address is registered on online platforms
- bulk check hundreds of usernames for availability
- osint investigation of a target's social media presence
- verify username availability before registering accounts
- check reserved or banned usernames accurately

## When to choose
- you need accurate username/email availability checks without false positives
- you want fast bulk queries via async concurrency
- you need both a CLI and an importable Python library
- you want email address checking, which most username checkers lack

## When to avoid
- you need coverage of platforms not in the supported list
- you need a GUI or web interface rather than CLI/library
- you need deep profile data extraction rather than availability status

## Facets
- artifact type: cli-tool
- maturity: active
- function: osint, cli, http-client, web-scraping
- domain: osint, social-media, security
- platform: python, cli, cross-platform
- tags: username-checker, email-checker, asyncio, account-availability, osint-tool, command-line

## Member repositories
- iojw/socialscan (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:41.388718+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:19:34.483975+00:00, confidence not recorded.
  - readme: https://github.com/iojw/socialscan (fetched 2026-08-28T04:05:41.388718+00:00, sha b6088e645f04)
  - registry_pypi: https://pypi.org/pypi/socialscan/json (fetched 2026-08-29T10:58:43.250584+00:00, sha 171b5ac47904)
- Data as of 2026-08-30T08:39:29.467469+00:00.