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

# API Reference — Email Address Harvesting

## theHarvester

### Multi-Source Search
```bash
theHarvester -d example.com -b all -l 500 -f output
```

### Specific Sources
```bash
theHarvester -d example.com -b google,bing,linkedin -l 200
theHarvester -d example.com -b shodan -l 100
```

### Available Sources
```
anubis, baidu, bing, binaryedge, bufferoverun, censys, certspotter,
crtsh, dnsdumpster, duckduckgo, fullhunt, github-code, google,
hackertarget, hunter, intelx, linkedin, netlas, otx, pentesttools,
projectdiscovery, rapiddns, rocketreach, securityTrails, shodan,
subdomainfinderc99, threatcrowd, threatminer, urlscan, virustotal, yahoo
```

## Hunter.io API

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

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

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

### Response Fields
```json
{
  "data": {
    "pattern": "{first}.{last}",
    "emails": [
      {
        "value": "john.doe@example.com",
        "type": "personal",
        "confidence": 94,
        "first_name": "John",
        "last_name": "Doe"
      }
    ]
  }
}
```

## Snov.io API

### Domain Search
```bash
curl -s "https://api.snov.io/v2/domain-emails-with-info" \
  -d "domain=example.com" -d "access_token=$SNOV_TOKEN"
```

## CrossLinked

### LinkedIn Email Generation
```bash
crosslinked -f '{first}.{last}@example.com' 'Company Name' -o emails.txt
crosslinked -f '{f}{last}@example.com' 'Company Name' -o emails_alt.txt
```

## h8mail

### Breach Check
```bash
h8mail -t user@example.com
h8mail -t emails.txt --breach-compilation /path/to/breachcomp
```

## Phonebook.cz

### Web Interface
```
https://phonebook.cz/ — search by domain, email, or URL
```

## Email Pattern Formats

| Pattern | Example |
|---------|---------|
| `{first}.{last}` | john.doe@example.com |
| `{f}{last}` | jdoe@example.com |
| `{first}{l}` | johnd@example.com |
| `{first}` | john@example.com |
| `{first}_{last}` | john_doe@example.com |
| `{last}.{first}` | doe.john@example.com |

## Environment Variables

| Variable | Description |
|----------|-------------|
| `HUNTER_API_KEY` | Hunter.io API key |
| `SNOV_TOKEN` | Snov.io access token |
| `HASHES_ORG_KEY` | Hashes.org API key for h8mail |
