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

# API Reference — Social Media Intelligence

## Sherlock

### Username Search
```bash
sherlock username --csv --print-found --output results.csv
```

### Multiple Usernames
```bash
sherlock user1 user2 user3 --csv
```

### Specific Sites
```bash
sherlock username --site github twitter instagram
```

## Maigret

### Deep Search
```bash
maigret username --html -a --timeout 30 -o report
```

### With PDF Report
```bash
maigret username --html --pdf -o report
```

### Tags Filter
```bash
maigret username --tags dating finance social
```

## Holehe

### Email Account Check
```bash
holehe email@example.com --no-color
```

### Python API
```python
import holehe.core as holehe
import asyncio

async def check(email):
    out = []
    await holehe.main(email, out)
    for r in out:
        if r["exists"]:
            print(f"{r['name']}: registered")
```

## GHunt

### Email Lookup
```bash
ghunt email target@gmail.com --json output.json
```

### Google Doc Owner
```bash
ghunt doc "https://docs.google.com/document/d/..." --json output.json
```

## GitHub API

### User Profile
```bash
curl -s "https://api.github.com/users/username" | jq '{login, name, bio, company, location}'
```

### User Repos
```bash
curl -s "https://api.github.com/users/username/repos" | jq '.[].full_name'
```

## Reddit API

### User About
```bash
curl -s -H "User-Agent: OSINT/1.0" "https://www.reddit.com/user/username/about.json"
```

## Social Analyzer

### Full Analysis
```bash
social-analyzer --username targetuser --metadata --extract --mode fast
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `GITHUB_TOKEN` | GitHub API token (higher rate limit) |
| `GOOGLE_COOKIES` | GHunt authentication cookies file |
