PAGES
← all tools
◆ Reconnaissance & OSINT

sherlock

v0.16.0 open-source

Hunt down social media accounts by username across social networks

Summary

Sherlock is an open-source command-line tool that searches for a given username across more than 400 social networks and reports back where accounts exist. It costs nothing to use, runs as a Python package installed via pipx, pip, uv, or Docker, and is aimed at OSINTOSINTOpen-source intelligence, collecting and analyzing information from publicly available sources. Investigators use it to learn about people, infrastructure or threats. researchers, investigators, and red teamers doing footprinting on a person or handle before an engagement. Results can be written to text, CSV, or JSON, and site lists can be loaded from an open pull request, which suits testing proposed additions before they merge or running searches in CI without leaving files on disk. It sits in the reconnaissance and OSINT space alongside other username-enumeration tools, filtering known false-positive-prone sites automatically to keep results clean. First committed in 2018, it remains active, with 322 contributors and steady commits over the past year.

Hunt down social media accounts by username across social networks

How sherlock helps

Which social networks does a given handle actually exist on?

checks the username against more than 400 site profiles and lists each one where an account was found, so a researcher gets a single sweep instead of checking sites by hand

Is this the same person's handle across platforms, or a coincidence?

running one username through the full site list surfaces where it resolves to a live profile versus a dead one, letting an investigator build out a footprint before an engagement

How do I keep a person-search running in a pipeline without littering the disk with result files?

results can be routed to CSV or JSON instead of the default text file, or suppressed from disk entirely, so a CI job can consume the output programmatically

Can I test a proposed new site check before it's merged into the tool?

a site manifest can be loaded straight from an open pull request's URI, so the added site gets searched immediately without waiting for a release

Which of my search results are just noise from sites prone to false positives?

known false-positive-prone sites are filtered out automatically based on ongoing upstream testing, keeping the returned list closer to real matches

Where did each hit actually come from, for follow-up verification?

each found account is written out per username to its own result file (or CSV/JSON record), giving a reviewable list to check by hand rather than trusting the tool's judgment alone

all 5 features, with the evidence for each →

Languages

Not documented

Features

5 capabilities · 5 backed by code, an API document or a real run

Built from sherlock's releases, docs, README and our own runs. “Seen” marks the month we first spotted a release the vendor didn't date. Group names and tags are our labels.

Compare with peers →

What sherlock offers you

  • Offline mode2
  • Command-line interface1
All capabilities 5 capabilities
Output file control verified Controls which report files are written after a search, including the option to suppress the default txt output file. 1 release · 3 other sources · first seen Sep 2025

release

  • Adds --no-txt flag to disable automatic plaintext file output. v0.16.0 · Sep 2025 · source · release history

command line

example

  • Run a username search without leaving a .txt results file on disk — useful in CI or ephemeral environments. sherlock --no-txt <username> v0.16.0 · Sep 2025 · source
Username search across social-media sites verified Searches for a given username across social-media platforms and reports matching accounts found. 4 other sources · first seen Aug 2026

Also counts toward: Offline mode

docs

  • Hunts down social media accounts by username across 400+ social networks.

we ran it

  • The tool treated the Dockerfile path as a literal username to search for across social-media sites and returned 0 results. Aug 2026 · the full run

example

  • Search for a single username sherlock user123
  • Search for multiple usernames at once sherlock user1 user2 user3
Upstream exclusion filtering verified Applies or bypasses upstream site exclusion lists when running a search, allowing users to trade precision for broader coverage. 2 releases · 2 other sources · first seen Sep 2025

release

  • Automatically filters the most false-positive-prone sites via upstream automated testing, reducing noise on an ongoing basis. v0.16.0 · Sep 2025 · source · release history
  • Overloads --json to accept pull request numbers as manifest URIs for loading custom site lists. v0.16.0 · Sep 2025 · source · release history

command line

  • --ignore-exclusions — Ignore upstream exclusions (may return more false positives) v0.16.0 · Sep 2025 · command-line history

example

  • Load a site manifest directly from an open pull request to test proposed site additions before they merge. sherlock --json 2356 <username> v0.16.0 · Sep 2025 · source
Offline / local mode verified Runs the tool without requiring network connectivity by skipping remote update checks, using a local data source instead. 1 release · 1 other source · first seen Jul 2024

Also counts toward: Command-line interface, Offline mode

release

  • --tor and --unique-tor flags deprecated due to optional torrequest dependency v0.15.0 · Jul 2024 · source · release history

we ran it

  • The tool treated the Dockerfile path as a literal username to search for across social-media sites and returned 0 results. Aug 2026 · the full run
HTTP response debugging verified Dumps the raw HTTP response to stdout to aid targeted debugging of requests made during a search. 1 release · 1 other source · first seen Jul 2024

release

  • Adds --dump-response flag to dump HTTP responses for easier debugging v0.15.0 · Jul 2024 · source · release history

command line

  • --dump-response — Dump the HTTP response to stdout for targeted debugging. v0.15.0 · Jul 2024 · command-line history

Lines in monospace are the tool's own words: help text parsed from its source, or an endpoint from its API document. Under release, a line is our summary of a dated release. Under docs, it is quoted from the tool's own documentation or website. Each links back to the source it came from.

Screenshots

From the release notes, newest first. Click one to see it full size.

CVE-2026-44590 May 7, 2026

Score card

  1. Shipping velocity releases a month, last 12 months
  2. Documentation quality release-notes rubric, 0–100
  3. Breaking-change discipline how rarely a release breaks users, and notice given
  4. Maintenance risk quiet time against its own cadence, maintainers
  5. Innovation & surface new capabilities, API and MCP surface
  6. Community health
  7. Contributor trend distinct committers, this year against last
  8. Maintainer concentration bus factor now against a year ago
  9. Issue backlog trend issues closed per issue opened, 12 months
  10. Responsiveness median time to a maintainer’s first reply

Nine scores for sherlock, each built from the releases, notes and API history this site tracks — and, on Researcher and Business, where it stands among every measured tool in its category and how that has moved.

Score cards are part of every paid plan.

See plans →

Each score is 0–100 on a published rubric, derived from data this site already shows. A dimension we cannot measure says so — it is never scored 0 and never enters a rank.

How this is scored
  • Shipping velocity — releases a month over the last 12 months, on a log scale where 16 a month scores 100. Needs 3 releases in the window.
  • Documentation quality — the release-notes rubric published on the analytics page, unchanged.
  • Breaking-change discipline — the share of releases carrying a breaking change (none scores 100, half or more scores 0). Only projects that label breaking changes are measured: a clean record cannot be told from an unlabelled one.
  • Maintenance risk — quiet time measured against the tool's own release cadence (quiet longer than 90 days and three typical gaps scores 0), plus the number of active maintainers and whether contributors are growing, where known. Higher is lower risk.
  • Innovation & surface — new capabilities in the feature ledger this year, API and MCP operations added, and the share of commits that are features: the mean of whichever we hold.
  • Community health (open-source tools only) — each is a direction, not a size: contributors this year against last, the bus factor now against a year ago, and issues closed per issue opened, where steady scores 50, doubled 100 and halved 0; plus the median time to a maintainer's first reply (an hour scores about 100, a month or more 0). A commercial card has no repository and carries none of the four.
  • Documented delivery (commercial tools) — when a vendor's documented new capabilities have slowed against its own baseline, that counts against the overall standing as heavily as two low dimensions. Steady delivery, or too little history to judge, leaves the standing alone; it is never a sixth score.
  • Open-source tools are scored on repository signals; commercial tools on their published changelog. Ranks compare tools within one category and one profile and need at least five measured peers; the overall standing needs three ranked dimensions. Best-in-breed or consolidator is a shape, not a quality, and is never scored.

Release-note detail over time

See how much detail sherlock puts in its release notes, quarter by quarter, and compare it with tracked tools in the same category. This history uses up to ten retained, reviewed notes per tool; sparse or blank older quarters may reflect that limit.

Checking release-note history…

Explore the full chart →

Releases

Show

3 entries

  1. May 20261
  2. September 20251
  3. July 20241
    Show

    3 entries

    Project health

    Issue, contributor and maintainer activity in sherlock-project/sherlock, 2023-10 – 2026-09, as of 2026-09-25. Twelve-month figures first; the trend lines run the whole window.

    1. Contributors 41 +10 vs prior 12 months
    2. Maintainers 16 +16 joined · −3 left, last 12 months
    3. Bus factor 8 committers behind half the commits
    4. Community-filed 97% of issues opened, last 12 months
    5. Median time to close 78 days first maintainer reply 26 hours
    6. Open backlog 108 of 1,190 issues ever filed
    1. Issues opened / month 9 · 0 communitymaintainers
    2. Open backlog 108
    3. Contributors / month 2
    4. Commits / month 4
    5. Stars 92,062
    Issue themes, last 12 months
    • bugs 16%
    • features 19%
    • questions 7%
    • other 58%

    Counts from the project's public repository and git history; no individuals are identified. Maintainers are the committers covering 80% of the last year's commits. how we measure this

    Libraries its release ships

    What its latest release locks, checked against known advisories.

    None of its release's images build from a lockfile we can read.

    Add the badge to your README

    Maintain this project? The badge links readers straight to this page, so they can follow every release here.

    Tracked by Cyber Toolchain Choose a badge style and copy the code →
    browse all tools → score card for your toolchain →