<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->

# API Reference — Conducting Cross-Platform Identity Correlation

## Sherlock

### Commands

| Command | Description |
|---|---|
| `sherlock <username>` | Check username across 400+ sites |
| `sherlock <username> --output results.txt` | Save results to file |
| `sherlock <username> --site twitter github` | Check specific sites |
| `sherlock <username> --csv` | Output as CSV |

## Platform Profile URLs

| Platform | URL Pattern |
|---|---|
| Twitter/X | `https://twitter.com/<username>` |
| GitHub | `https://github.com/<username>` |
| Reddit | `https://reddit.com/user/<username>` |
| Telegram | `https://t.me/<username>` |
| Instagram | `https://instagram.com/<username>` |
| YouTube | `https://youtube.com/@<username>` |
| TikTok | `https://tiktok.com/@<username>` |
| VKontakte | `https://vk.com/<username>` |
| LinkedIn | `https://linkedin.com/in/<username>` |

## Correlation Scoring

| Signal | Weight |
|---|---|
| Exact username match | 0.30 |
| Same profile photo | 0.25 |
| Same email address | 0.20 |
| Similar writing style | 0.10 |
| Overlapping connections | 0.10 |
| Matching timezone | 0.05 |
| **Match threshold** | **0.70** |

## Agent Script

```bash
node agent.js username-search --username "target" --platforms twitter,github,reddit
node agent.js stylometry --sample1 text_a.txt --sample2 text_b.txt
node agent.js activity-pattern --posts posts.json --timezone-detect
node agent.js build-profile --username "target" --data collected.json
node agent.js --self-test
```
