Apollo.io Enrichment

## Setup

1. Get your API key from [Apollo Settings](https://app.apollo.io/#/settings/integrations/api)
2. Set the environment variable:
   ```bash
   export APOLLO_API_KEY=your-api-key-here
   ```

## Usage

All commands use the bundled `apollo.py` script in this skill's directory.

### Enrich a Person

Get email, phone, title, and company data for a contact.

```bash
# By email
python3 apollo.py enrich --email "[email protected]"

# By name + company
python3 apollo.py enrich --name "John Smith" --domain "acme.com"

# Include personal email & phone
python3 apollo.py enrich --email "[email protected]" --reveal-email --reveal-phone
```

### Bulk Enrich People

Enrich up to 10 people in one call.

```bash
# From JSON file with array of {email, first_name, last_name, domain}
python3 apollo.py bulk-enrich --file contacts.json

# Reveal personal contact info
python3 apollo.py bulk-enrich --file contacts.json --reveal-email --reveal-phone
```

**contacts.json example:**
```json
[
  {"email": "[email protected]"},
  {"first_name": "Jane", "last_name": "Doe", "domain": "techcorp.io"}
]
```

### Enrich a Company

Get industry, revenue, employee count, funding data.

```bash
python3 apollo.py company --domain "stripe.com"
```

### Search for People

Find prospects by criteria.

```bash
# By title and company
python3 apollo.py search --titles "CEO,CTO" --domain "acme.com"

# By title and location
python3 apollo.py search --titles "VP Sales" --locations "San Francisco"

# Limit results
python3 apollo.py search --titles "Engineer" --domain "google.com" --limit 10

# Exclude competitors (Hathora/Edgegap/Nakama)
python3 apollo.py search --titles "CTO" --exclude-competitors
```

**Filtering Options:**
- `--exclude-competitors` or `-x` — Automatically filters out employees from Hathora, Edgegap, and Nakama (Heroic Labs)

## Example Prompts

- *"Enrich [email protected] with Apollo"*
- *"Get company info for stripe.com"*
- *"Find CTOs at fintech companies in NYC"*
- *"Bulk enrich this list of contacts"*
- *"What's the employee count and revenue for Notion?"*

## Data Returned

**Person enrichment:**
- Name, title, headline
- Email (work & personal)
- Phone (direct & mobile)
- Company, industry
- LinkedIn URL
- Location

**Company enrichment:**
- Name, domain, logo
- Industry, keywords
- Employee count, revenue
- Funding rounds, investors
- Technologies used
- Social links

## Credits

Apollo uses credits for enrichment. Check your usage at [apollo.io/settings/credits](https://app.apollo.io/#/settings/credits).