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

# API Reference — Employee Profiling

## Hunter.io

### Domain Search
```bash
curl -s "https://api.hunter.io/v2/domain-search?domain=example.com&api_key=$HUNTER_KEY" | jq '.data'
```

### Email Finder
```bash
curl -s "https://api.hunter.io/v2/email-finder?domain=example.com&first_name=John&last_name=Smith&api_key=$HUNTER_KEY"
```

### Email Verifier
```bash
curl -s "https://api.hunter.io/v2/email-verifier?email=user@example.com&api_key=$HUNTER_KEY"
```

### Rate Limits
- Free: 25 searches/month, 50 verifications/month
- Starter: 500 searches/month

## theHarvester

### Basic Usage
```bash
theHarvester -d example.com -b google,bing,linkedin -l 500
```

### All Sources
```bash
theHarvester -d example.com -b all -l 200 -f output.json
```

## CrossLinked

### LinkedIn Scraping
```bash
crosslinked -f '{first}.{last}@example.com' "Example Corporation"
```

### Custom Format
```bash
crosslinked -f '{f}{last}@example.com' "Example Corporation" -o employees.txt
```

## Sherlock

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

## Holehe

### Email Registration Check
```bash
holehe user@example.com --only-used --no-color
```

## PhoneInfoga

### Phone Lookup
```bash
phoneinfoga scan -n "+15551234567"
phoneinfoga serve -p 5000  # Web UI
```

## h8mail

### Breach Check
```bash
h8mail -t user@example.com --config h8mail_config.ini -o results.json
```

### Config File
```ini
# h8mail_config.ini
[h8mail]
snusbase_url = https://api.snusbase.com/data/search
snusbase_token = YOUR_TOKEN
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `HUNTER_API_KEY` | Hunter.io API key |
| `SNUSBASE_TOKEN` | Snusbase API token |
