Blitz List Builder

Blitz List Builder

Prospeo is title-first: "all VPs of Marketing in B2B SaaS." Blitz is domain-first: "for each of these 500 restaurant domains, find the owner."

If you already know the target companies (from Google Maps, a CSV of competitors, or a manually-curated list), Blitz finds the people for you.

When to use Blitz vs Prospeo

Often: use Prospeo to build the initial list, then Blitz to add 1-2 more contacts per company.

Prerequisites

• Blitz API key (env: BLITZ_API_KEY) — sign up at their website
• List of target company domains (CSV with a company_domain column, or one domain per line)

Inputs

• --domains-file=<path> — CSV or txt with company domains (one per line, or a column named company_domain)
• --titles=<csv> — comma-separated title keywords to filter (default: owner,founder,ceo,president,cto,vp)
• --out=<path> — CSV output path

Outputs

CSV with columns: company_domain, first_name, last_name, job_title, linkedin_url, email, email_source, company_name, company_industry, company_headcount, company_phone

Email will be populated when Blitz returns one. Use /list-builder Phase 5 (scripts/contacts.ts) on the output to fill in missing emails, then validate with MillionVerifier (/cold-email-starter-kit).

Usage

bashCopy code
export BLITZ_API_KEY=xxx

# Pull owner/founder/CEO contacts for 5000 SMB domains
npx tsx scripts/find-contacts.ts \
  --domains-file=restaurants.csv \
  --titles=owner,founder,ceo,general-manager \
  --out=restaurant-owners.csv

# Domain-first discovery with custom title match
npx tsx scripts/find-contacts.ts \
  --domains-file=saas-companies.txt \
  --titles=vp-marketing,head-of-growth,cmo,director-marketing \
  --out=saas-marketers.csv

API overview

Blitz has two main endpoints we use:

Company enrichment (find employees):

Copy code
POST {BLITZ_BASE_URL}/api/enrichment/company
Body: { "domain": "acme.com" }
Response: { employees: [{ first_name, last_name, title, linkedin_url, email }], company: { name, industry, headcount, phone } }

Email enrichment (find email for a LinkedIn URL):

Copy code
POST {BLITZ_BASE_URL}/api/enrichment/email
Body: { "linkedin_profile_url": "https://linkedin.com/in/..." }
Response: { email: "...", status: "verified" }

Rate limiting

The script throttles at 30 requests/second with concurrency 10. This matches Blitz's published limits. If you see 429s, lower the concurrency flag.

Hit rate expectations

Rough benchmarks (from real campaigns):

• SMBs (restaurants, clinics, salons): 70-80% contact-found rate, 40-60% email-found
• B2B tech (10-500 employees): 80-90% contact-found, 50-70% email-found
• Enterprise (>1000 employees): 90%+ contact-found, but filtering for the RIGHT person matters more than the found-rate
• Solo operators / micro-businesses: 30-50% — often no public LinkedIn

Title filtering — write specific keywords

Default keywords (owner, founder, ceo, president, cto, vp) are broad. Narrow them per campaign:

bashCopy code
# Restaurants
--titles=owner,operator,general-manager

# SaaS RevOps
--titles=revops,revenue-operations,vp-sales,director-sales

# Dental practices
--titles=dentist,owner,practice-manager

# Law firms
--titles=partner,managing-partner,principal

The script does case-insensitive substring match. "vp" matches "VP Sales" but also "VP Product" — narrow further if that's too loose.

Common gotchas

• Domain must be just the bare domain. Blitz wants acme.com, not https://acme.com/ or sub.acme.com.
• Huge companies return truncated employee lists. Blitz caps at ~50-100 employees per domain. For enterprise-heavy lists, use Prospeo or LinkedIn search instead.
• Stale LinkedIn data. Blitz's cache can be 3-12 months old. Job titles may have changed. Validate with the email waterfall.
• No email returned ≠ person unreachable. 40% of hits have no email. Feed them to /list-builder Phase 5 (scripts/contacts.ts), which tries GetLeads, Blitz and Prospeo in cost order.
• Rate-limit errors. 429 = you hit the cap. Script retries with exponential backoff, but long bursts still fail.

Required step: Qualify with /icp-prompt-builder

This is a required step. Do not skip it.

Before pulling more than 500 companies' worth of contacts, sample ~50 and run /icp-prompt-builder on them:

1. Evaluates the first 10 with an AI qualification prompt
2. You give corrections ("this one should be NO because they're a competitor")
3. Refines the prompt, runs next 10
4. Stops after 2 rounds with zero corrections — prompt is tuned
5. Apply the tuned prompt to the remaining leads to filter before paying for email enrichment

Why it's required: Blitz contact-finding is cheap, but email enrichment downstream is not. A typical 5,000-contact run costs $150+ in email-finding API calls. If 40% of your list is wrong-fit, you burn ~$60 finding emails at companies that will never convert. The ICP prompt builder takes 10-15 min and saves that.

How to skip safely: you can't. If you're sure your list is already perfectly qualified (e.g., it came from a curated seed list of named accounts you want to pitch), run /icp-prompt-builder anyway on 10 of them and confirm your existing qualification matches — the prompt builder becomes a sanity check instead of a filter.

Cost

Per Blitz pricing (check their current rates):

• Company enrichment: ~$0.02-0.05 per domain
• Email enrichment: ~$0.05-0.10 per email

5,000 domains = ~$150 for contacts alone. Plan your budget.

Output → next step

Once you have the CSV, the typical flow:

1. Deduplicate — remove duplicate emails, duplicate LinkedIn URLs
2. Filter — drop rows where job_title doesn't cleanly match your ICP
3. Fill missing emails — run /list-builder (Phase 5, emails) on rows with empty email
4. Validate — run MillionVerifier on all emails (see /cold-email-starter-kit for the MillionVerifier script)
5. Upload — pass to Smartlead via /cold-email-starter-kit script smartlead-add-leads.ts

Scripts

• scripts/find-contacts.ts — main batch enrichment script

What to do next

Run /list-builder (Phase 5, emails) to fill in emails for rows Blitz didn't return. Then /list-quality-scorecard to grade the final list.

After the scorecard, proceed to /campaign-copywriting → /smartlead-campaign-upload-public.

Or wait: if the required /icp-prompt-builder step (above) showed <40% qualification rate, your source list of domains is off. Fix that before spending more Blitz credits.

Related skills

• /icp-prompt-builder — qualify the contacts this skill returns BEFORE running email waterfall
• /prospeo-full-export — the title-first alternative
• /google-maps-list-builder — for local-business domain lists
• /disco-like — lookalike companies from seed domains
• /list-builder (Phase 5, emails) — when Blitz doesn't return an email
• /cold-email-starter-kit → 06-list-building-prospeo.md for broader list-building context