Socialscan

2.0.1

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

Verified 24 Sept 2026
pip 2.0.1
MPL-2.0
1.8k stars

Source on GitHub · PyPI release · Markdown

Install and run

otlite install socialscan
Installs socialscan==2.0.1 into its own virtualenv. otlite lists what it will install and asks before it starts.
otlite run socialscan -- q:example
socialscan receives socialscan example

No otlite yet? Install it in one line

curl -fsSL https://get.otinstaller.com/otlite | sh

Linux and macOS, no Docker. It uses your Python and pipx when both are there, and otherwise brings its own Python. About otlite · otlite docs

What it takes

Typed inputs after -- become Socialscan's own arguments. Anything else after -- passes through unchanged, so every option of the tool still works.

Input	With otlite	`socialscan` receives
Search term`q:`	`otlite run socialscan -- q:example`	`socialscan example`

What a run leaves

Every run is saved under results/ where you run otlite (or --output, or OTLITE_RESULTS_DIR): what the tool printed, a sidecar with how it ran, and an envelope.

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

{
  "envelope": 1,
  "tool": "socialscan@2.0.1",
  "runtime": "otlite",
  "input": { "target": "example" },
  "case": null,
  "started_at": "…", "ended_at": "…", "duration_ms": …,
  "exit_code": 0,
  "status": "complete",
  "entities": [{ "type": "url", "value": "…" }, …],
  "warnings": [],
  "output": { "path": "results/socialscan/example/<time>_socialscan_example_<run id>.txt", "sha256": "…", "bytes": … }
}

The envelope's shape, the same for every tool; values elided. Its entities are the emails, domains, IP addresses and URLs found in the output, or the tool's own when it prints them.

otlite results --tool socialscan

otlite extract socialscan

otlite diff socialscan example

List the saved runs, pull out every indicator, or compare the two latest runs against the same target.

With other tools

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

Also on the OTInstaller registry

Prefer a sandbox? osintverse-community/socialscan runs Socialscan with ot: pinned and scanned, in a locked-down container with no access to your files and no network unless it needs one. Linux, macOS and Windows, with Docker or Podman.

ot install osintverse-community/socialscan

Related tools

All 47 tools →