Skip to main content
The web application provides the most feature-rich and user-friendly way to use Social Analyzer. It includes all detection modes, visualization tools, metadata extraction, and an intuitive interface for OSINT investigations.
The web application is the preferred method for using Social Analyzer as it provides access to all features including advanced visualizations and real-time progress monitoring.

​
Quick Start

1

Install dependencies

Install Node.js and required system packages:
sudo apt-get update
sudo apt-get install -y firefox-esr tesseract-ocr git nodejs npm
2

Clone and setup

git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
npm update
npm install
3

Start the server

npm start
The server will start on port 9005 (or the port specified in PORT environment variable).
4

Open in browser

Navigate to:
http://localhost:9005/app.html

​
Interface Overview

The web interface consists of several key sections:

​
Search Panel

The main search interface where you configure your analysis:
  • Username field: Enter one or multiple usernames (comma-separated)
  • Website selector: Choose which platforms to search
  • Analysis options: Select detection modes and features
  • Advanced settings: Configure proxy, user-agent, and API keys

​
Results Panel

Displays detected profiles with:
  • Detection confidence rating (percentage)
  • Profile metadata and screenshots
  • Extracted information (links, patterns)
  • Quality indicators (good/maybe/bad)

​
Visualization Panel

Shows force-directed graphs and statistical analysis when metadata extraction is enabled.

​
Search Configuration

​
Username Input

Enter a single username to analyze:
johndoe

​
Website Selection

Check the “Select All” option to search across all 900+ supported platforms.

​
Analysis Options

​
Detection Modes

Select which detection techniques to use:
FindUserProfilesFast / GetUserProfilesFast
  • Quick detection using basic techniques
  • HTTP-based analysis
  • Checks for username presence in page content
  • Recommended for initial scans
  • Fastest execution time
Use when: You need quick results or are scanning many platforms.

​
Information Extraction

1

Extract Patterns

Enable ExtractPatterns to extract:
  • URLs and web links
  • Email addresses
  • Social media handles
  • Other regex-matched patterns
2

Extract Metadata

Enable ExtractMetadata to extract:
  • Open Graph meta tags
  • Twitter Card data
  • Schema.org structured data
  • Page descriptions and keywords
  • Profile images
Required for visualization features.

​
Analysis Features

Analyze the username structure:
  • SplitWordsByUpperCase: Split camelCase usernames
  • SplitWordsByAlphabet: Split by character patterns
  • FindNumbers: Extract numeric components
  • FindSymbols: Identify special characters
  • ConvertNumbers: Convert leetspeak (3 → e)
  • FindAges: Guess possible ages from numbers

​
Advanced Settings

Access advanced configuration via the settings panel:

​
Proxy Configuration

http://proxy.example.com:8080
Route requests through a proxy server for anonymity or to bypass restrictions.

​
Custom User-Agent

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
Modify the User-Agent header to simulate different browsers.

​
Google API Integration

1

Obtain API credentials

Get API key and Custom Search Engine ID from Google Cloud Console.
2

Enter credentials

  • Google API Key: Your API key
  • Google Custom Search ID: Your CSE ID
3

Enable custom search

Check CustomSearch in analysis options.

​
Working with Results

​
Understanding Confidence Ratings

Each detected profile receives a percentage rating:
RatingBadgeDescription
100%GoodHigh confidence - profile definitely exists
50-99%MaybeMedium confidence - profile likely exists
Below 50%BadLow confidence - uncertain or false positive

​
Filtering Results

Use the filter controls to refine results:
  • Show Good: Only high-confidence matches
  • Show Maybe: Include medium-confidence matches
  • Show Bad: Include low-confidence matches
  • Show Unknown: Profiles that couldn’t be verified
  • Show Failed: Failed connection attempts

​
Viewing Profile Details

Click on any detected profile to view:
  • Full profile URL
  • Page title and language
  • Extracted text content
  • Website type and country
  • Global ranking
  • Screenshots (if available)
  • Metadata (if extraction enabled)
  • Extracted patterns (if extraction enabled)

​
Exporting Results

Results can be exported in multiple formats:
  1. JSON Download: Click “Download JSON” for machine-readable data
  2. Copy Links: Copy all profile links to clipboard
  3. Screenshots: Download captured screenshots

​
Visualization Features

​
Force-Directed Network Graph

When NetworkGraph and ExtractMetadata are enabled:
  • Nodes represent detected profiles and extracted entities
  • Links show relationships and connections
  • Interactive: drag, zoom, and explore
  • Hover over nodes for details

​
Statistics Dashboards

When CategoriesStats or MetadataStats are enabled:
  • Pie charts showing distribution by category
  • Bar charts for country distribution
  • Metadata frequency analysis
  • Language distribution

​
Real-Time Progress Monitoring

The web interface provides live updates:
  • Progress bar showing completion percentage
  • Real-time log output
  • Current website being checked
  • Number of profiles found
  • Ability to cancel ongoing scans

​
Example Workflows

1

Enter username

Type the username in the search field: johndoe
2

Select websites

Choose “Top 100” for a quick scan of popular platforms.
3

Enable fast mode

Check FindUserProfilesFast.
4

Start search

Click “Find” and wait for results.
5

Review results

Browse detected profiles with good ratings.

​
Deep Investigation

1

Multiple usernames

Enter variations: johndoe,john_doe,johndoe99
2

Select all websites

Check “Select All” for comprehensive coverage.
3

Enable all extraction

  • Check ExtractPatterns
  • Check ExtractMetadata
  • Check FindOrigins
4

Enable visualization

  • Check NetworkGraph
  • Check CategoriesStats
5

Use advanced mode

Select FindUserProfilesSlow for thorough analysis.
6

Analyze results

Review the network graph to identify connections and patterns.
1

Enter username

Type the target username.
2

Filter by category

Select only “Music” or “Gaming” platforms from the list.
3

Enable extraction

Check ExtractPatterns to find linked accounts.
4

Start search

Click “Find” to search category-specific platforms.

​
Logs and Debugging

View detailed logs in the browser console or in the log output panel: 
[init] Detections are updated very often, make sure to get the most up-to-date ones
[Setting] Username: johndoe
[Starting] Checking user profiles normal
[Checking] twitter.com
[Checking] github.com
[Done] Checking user profiles normal
[Finished] Analyzing: johndoe Task: abc123

​
API Endpoints

The web app exposes several API endpoints for custom integrations:

​
POST /analyze_string

Analyze a username: 
{
  "string": "johndoe",
  "uuid": "unique-task-id",
  "option": "FindUserProfilesFast,ExtractMetadata"
}

​
GET /get_settings

Retrieve current settings: 
{
  "proxy": "http://proxy.example.com:8080",
  "user_agent": "Mozilla/5.0...",
  "websites": [...]
}

​
POST /save_settings

Update configuration: 
{
  "proxy": "http://new-proxy.com:8080",
  "user_agent": "Custom Agent",
  "websites": "0,1,2,5,10"
}

​
Security Considerations

The web application is designed to run locally only. It does not have built-in access control or authentication. Do not expose it to the internet without proper security measures.
  • Run only on localhost or trusted networks
  • Use a firewall to restrict access
  • Do not save sensitive API keys in the interface
  • Clear browser storage after sensitive investigations

​
Performance Tips

  • Start with Fast Mode and Top 100 websites for quick results
  • Use Slow Mode only when necessary (significantly slower)
  • Enable metadata extraction only when you need detailed analysis
  • Disable visualization options if not needed (reduces processing time)
  • For very thorough scans, run overnight or during off-hours
  • Use website filtering to reduce scope and increase speed

​
Troubleshooting

Server won’t start Check that port 9005 is not in use: 
lsof -i :9005
Use a different port: 
PORT=8080 npm start
No results showing Check browser console for errors (F12) and review server logs. Slow performance Reduce the number of websites or disable advanced detection modes. Visualization not working Ensure ExtractMetadata is enabled before enabling NetworkGraph.

Build docs developers (and LLMs) love

Get started for freeTalk to us