# Blitz Enrich

> BlitzAPI contact enrichment — Domain to LinkedIn to ICP decision-makers to verified emails. Single-API pipeline. USE WHEN user says "blitz-enrich" OR "blitz enrich" OR "find decision makers" OR "ICP contacts" OR "domain to contacts" OR "find contacts at companies" OR wants to find C-suite/VP/Director contacts from a list of company domains.

- Skill: `revgrowth1/blitz-enrich` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add revgrowth1/blitz-enrich`
- Raw SKILL.md: https://api.skillmd.com/api/skills/revgrowth1/blitz-enrich/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Revgrowth1 (https://skillmd.com/u/revgrowth1)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/revgrowth1/blitz-enrich

---


# BlitzAPI Contact Enrichment Pipeline

Domain -> LinkedIn Company URL -> ICP Decision-Makers -> Verified Work Emails. All steps powered by BlitzAPI with Prospeo/IcyPeas email fallbacks.

## 3-Step Pipeline

|Step|What It Does|Credits|
|---|---|---|
|1|Domain -> LinkedIn company URL|1/domain|
|2|Waterfall ICP search -> decision-maker contacts|1/contact found|
|3|Email waterfall (BlitzAPI -> Prospeo -> IcyPeas)|1/email (Blitz only)|

## Default ICP Cascade (configurable)

|Tier|Titles|
|---|---|
|1|CEO, Founder, Owner, President, Co-Founder|
|2|VP Marketing, VP Sales, VP Growth, CMO, CRO|
|3|Marketing Director, Sales Director, Director of Growth|

Max 3 contacts per company. Custom cascade via `--cascade-json`.

## Execution

```bash
# Standard run
python3 ./blitz_enrich.py input.csv -o contacts.csv

# Dry run (estimate credits without calling APIs)
python3 ./blitz_enrich.py input.csv --dry-run

# Limit companies, skip email step
python3 ./blitz_enrich.py input.csv -o contacts.csv --max-companies 50 --skip-email

# More contacts per company
python3 ./blitz_enrich.py input.csv -o contacts.csv --max-results 5
```

## Input CSV

Needs a domain column (auto-detected from: `domain`, `website`, `company_domain`, `url`, `website url`, `company website`). Optional `company` / `company name` column.

## Output

Creates `{input}_enriched.csv` with columns: `company`, `domain`, `company_linkedin_url`, `first_name`, `last_name`, `full_name`, `job_title`, `linkedin_headline`, `person_linkedin_url`, `email`, `email_source`, `all_emails`, `country`, `person_city`, `icp_tier`, `what_matched`.

Also saves raw JSON for debugging.

## API Keys

Resolved: CLI flag -> env var -> `~/.env`.

|Key|Required|Purpose|
|---|---|---|
|`BLITZ_API_KEY`|Yes|All 3 steps|
|`PROSPEO_API_KEY`|No|Email fallback #1|
|`ICYPEAS_API_KEY` + `ICYPEAS_API_SECRET`|No|Email fallback #2|

Script: `./blitz_enrich.py`

