Skip to main content
This guide will help you run your first profile search with Social Analyzer.

​
Prerequisites

Before you begin, make sure you have one of the following installed:
  • Node.js 20.18.1 or higher
  • npm (comes with Node.js)
  • Firefox ESR or Chrome browser
  • Tesseract OCR (optional, for advanced detection)

​
Installation

1

Install Social Analyzer

Choose your preferred installation method:
# Clone the repository
git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer

# Install dependencies
npm install
2

Verify Installation

Test that Social Analyzer is working:
node app.js --list
This should display a list of supported websites.
Let’s run a basic username search: 
node app.js --username "johndoe"
This will search for the username “johndoe” across all 1000+ supported social media websites using the fast detection mode.
The first search may take a few minutes as Social Analyzer checks each website. Subsequent searches are typically faster.

​
Understanding the Output

Social Analyzer displays results with confidence ratings:
  • Good (100%): High confidence - profile definitely exists
  • Maybe (50-99%): Medium confidence - profile likely exists
  • Bad (Below 50%): Low confidence - uncertain or false positive
Example output: 
[Detected] YouTube - https://youtube.com/@johndoe (Rate: 100%)
[Detected] Twitter - https://twitter.com/johndoe (Rate: 85%)
[Maybe] Instagram - https://instagram.com/johndoe (Rate: 65%)

​
Common Use Cases

​
Search Specific Websites

If you only want to check specific platforms: 
node app.js --username "johndoe" --websites "youtube twitter instagram"

​
Search Top-Ranked Sites

Focus on the most popular websites for faster results: 
node app.js --username "johndoe" --top 50

​
Extract Metadata

Get additional profile information and metadata: 
node app.js --username "johndoe" --metadata --extract

​
JSON Output

Get machine-readable output for integration with other tools: 
node app.js --username "johndoe" --output json

​
Web Interface

Social Analyzer also provides a web-based GUI:
1

Start the Web Server

node app.js --gui
2

Open in Browser

Navigate to http://localhost:9005/app.html in your web browser
3

Enter Username

Type a username in the search box and click “Find”
4

View Results

Results will appear with confidence ratings, and you can filter by quality (good/maybe/bad)

​
Next Steps

Now that you’ve run your first search, explore more features:

Detection Modes

Learn about fast, slow, and special detection modes

Configuration Options

Customize Social Analyzer with advanced options

Metadata Extraction

Extract detailed information from profiles

CLI Reference

Complete command-line reference

​
Tips for Better Results

Use specific usernames: Social Analyzer works best with exact usernames rather than common names or partial matches.
Filter results: Use --filter good to only see high-confidence matches and reduce false positives.
Search by region: Use --countries to focus on websites popular in specific regions for faster, more relevant results.

​
Troubleshooting

Try using --top 50 to limit searches to top-ranked websites, or use --mode fast (default) instead of slow mode.
Use --filter good to only show high-confidence matches, or use --mode slow for more accurate detection.
Make sure Firefox ESR or Chrome is installed. For Node.js, geckodriver is installed automatically with npm. For Python, you may need to install it separately.
Use --proxy with a proxy server, or reduce the number of concurrent requests. Some websites have rate limiting and may temporarily block requests.
Need more help? Check the Troubleshooting Guide or FAQ.

Build docs developers (and LLMs) love

Get started for freeTalk to us