# Socialscan (otlite)

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

- Takes: Username, Email
- Install: `otlite install socialscan`, into its own virtualenv
- Pinned: [socialscan==2.0.1](https://pypi.org/project/socialscan/2.0.1/)
- Command: `socialscan`
- Python: any otlite runs on (3.10 or newer)
- Verified: 24 Sept 2026, version 2.0.1 on Ubuntu 26.04 LTS, Python 3.12.14
- Licence: MPL-2.0; 1,845 GitHub stars
- Source: https://github.com/iojw/socialscan

otlite is the no-Docker edition of OTInstaller for Linux and macOS: [install it](https://otinstaller.com/otlite) with `curl -fsSL https://get.otinstaller.com/otlite | sh`.

## Run it

| Input | otlite command | Socialscan receives |
| --- | --- | --- |
| Search term | `otlite run socialscan -- q:example` | `socialscan example` |

Arguments after `--` that aren't typed inputs go to the tool unchanged.

## What a run leaves

- `results/socialscan/example/<time>_socialscan_example_<run id>.txt`
- `results/socialscan/example/<time>_socialscan_example_<run id>.meta.json`
- `results/socialscan/example/<time>_socialscan_example_<run id>.envelope.json`

The envelope is the same shape for every tool: the tool and version, the input, timing, exit code and status, the emails, domains, IP addresses and URLs found in the output, and the output file's path, hash and size. `otlite results --tool socialscan` lists saved runs, `otlite extract socialscan` pulls out indicators and `otlite diff socialscan example` compares the two latest runs.

## With other tools

Batch runs can't pass it a value; run it on its own.

## Related tools

- [Spiderfoot](https://otinstaller.com/otlite/tools/spiderfoot.md): SpiderFoot automates OSINT for threat intelligence and mapping your attack surface
- [Blackbird](https://otinstaller.com/otlite/tools/blackbird.md): OSINT tool to search for accounts by username and email across social networks
- [User Scanner](https://otinstaller.com/otlite/tools/user-scanner.md): (2-in-1) Email & Username OSINT suite featuring native MCP support for deep data extraction just from a single Email/Username
- [Fsociety](https://otinstaller.com/otlite/tools/fsociety.md): A Modular Penetration Testing Framework
- [Openosint](https://otinstaller.com/otlite/tools/openosint.md): AI-powered OSINT agent with interactive REPL, MCP server, and direct CLI modes
- [Crosslinked](https://otinstaller.com/otlite/tools/crosslinked.md): LinkedIn enumeration tool to extract valid employee names from an organization through search engine scraping

[All 47 otlite tools](https://otinstaller.com/otlite/tools) · [otlite docs](https://otinstaller.com/docs/otlite.md)