Updated Jul 14, 2026

Social Engineering

Map social accounts for a username

Username checks across social networks with optional CSV export.

Agent

overview

What sherlock does

sherlock takes one or more usernames and checks them across many social networks by requesting each profile URL. Hits show where the handle is registered.

Scope platforms with --site. Export with --csv or --xlsx. Keep only finds via --print-found. Route traffic with --proxy and bound waits with --timeout.

Trickest runs sherlock as a managed Social Engineering node that writes FILE and FOLDER. Start identity OSINT here, then hand profiles to correlation or manual review. Prefer socialscan for availability checks.

source github.com/sherlock-project/sherlock

use cases

Where sherlock fits

Map an identity's social footprint

Check a username across hundreds of networks to find every platform where the handle is registered, the starting point for an OSINT investigation.

Export hits to a spreadsheet

Write CSV or XLSX output so found accounts land in a structured file ready for review, correlation, or reporting.

Narrow to specific platforms

Limit analysis with --site to a chosen list of networks when an investigation only cares about a handful, cutting run time and noise.

Route checks through a proxy

Send requests over a SOCKS or HTTP proxy with --proxy to mask origin or work around rate limits while enumerating accounts.

reference

sherlock inputs and flags

11 inputs
NameTypeFlagDescription
usernamesSTRING·One or more usernames to check across social networks.
limit-analysis-to-sitesSTRING--siteLimit analysis to only the listed sites.
csvBOOLEAN--csvWrite results to a comma-separated values (CSV) file.
xlsxBOOLEAN--xlsxWrite results to a Microsoft Excel spreadsheet (xlsx).
print-foundBOOLEAN--print-foundOutput only the sites where the username was found.
proxy-urlSTRING--proxyMake requests over a proxy, e.g. socks5://127.0.0.1:1080.
time-to-wait-for-responseSTRING--timeoutSeconds to wait for a response before moving on (default 60).
load-data-from-jsonFILE--jsonLoad the site list from a local or online JSON file.

Showing key inputs. sherlock exposes 11 inputs in total.

Full flag reference (11 inputs)
NameTypeFlagDescription
usernamesSTRING·One or more usernames to check across social networks.
csvBOOLEAN--csvCreate a comma-separated values (CSV) file of results.
xlsxBOOLEAN--xlsxCreate a Microsoft Excel spreadsheet (xlsx) of results.
print-foundBOOLEAN--print-foundOutput only the sites where the username was found.
print-allBOOLEAN--print-allOutput sites where the username was not found as well.
limit-analysis-to-sitesSTRING--siteLimit analysis to only the listed sites.
proxy-urlSTRING--proxyMake requests over a proxy, e.g. socks5://127.0.0.1:1080.
time-to-wait-for-responseSTRING--timeoutTime in seconds to wait for a response to requests (default 60).
load-data-from-jsonFILE--jsonLoad site data from a local or online, valid JSON file.
nsfwBOOLEAN--nsfwInclude NSFW sites from the default list in the check.
no-color-outputBOOLEAN--no-colorDo not color the terminal output.

example

Run sherlock

sherlock · command
# find where a handle exists and export the hits to CSVsherlock ksokolov --print-found --csv --timeout 30
sample output
[*] Checking username ksokolov on:[+] GitHub: https://www.github.com/ksokolov[+] GitLab: https://gitlab.com/ksokolov[+] Reddit: https://www.reddit.com/user/ksokolov[+] Instagram: https://www.instagram.com/ksokolov[+] Twitter: https://twitter.com/ksokolov[+] Pinterest: https://www.pinterest.com/ksokolov[+] TikTok: https://www.tiktok.com/@ksokolov

guidance

Choosing sherlock

Use to map where a username already exists across social networks. It checks handles, not emails. Prefer socialscan for email or username availability. Prefer socialhunter for broken social links on a site.

socialscan

Checks whether an email or username is available, taken, or invalid. Sherlock finds where a handle already exists.

socialhunter

Crawls a site for hijackable broken social links rather than enumerating one identity's accounts.

shodan-python

Device and service intel. A different OSINT axis from social identity.

faq

sherlock questions

Pass one or more usernames. Sherlock requests each platform profile URL and lists hits. On Trickest, set the usernames input on the node.

Run sherlock yourself

A username feeds sherlock, which checks it across hundreds of networks and writes the found accounts as a queryable output.

Facts on this page come from the live Trickest tool library.