Apollo.io Enrichment
@capt-marbles
npx machina-cli add skill @capt-marbles/apollo-enrichment --openclawApollo Enrichment Skill
Enrich contacts and companies using Apollo.io API.
Setup
- Get your API key from Apollo Settings
- Set the environment variable:
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.
# By email
python3 apollo.py enrich --email "john@acme.com"
# By name + company
python3 apollo.py enrich --name "John Smith" --domain "acme.com"
# Include personal email & phone
python3 apollo.py enrich --email "john@acme.com" --reveal-email --reveal-phone
Bulk Enrich People
Enrich up to 10 people in one call.
# 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:
[
{"email": "john@acme.com"},
{"first_name": "Jane", "last_name": "Doe", "domain": "techcorp.io"}
]
Enrich a Company
Get industry, revenue, employee count, funding data.
python3 apollo.py company --domain "stripe.com"
Search for People
Find prospects by criteria.
# 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-competitorsor-x— Automatically filters out employees from Hathora, Edgegap, and Nakama (Heroic Labs)
Example Prompts
- "Enrich john@acme.com 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.
Overview
Apollo Enrichment lets you augment people with email, phone, title, and company data, while enriching organizations with industry, revenue, employee count, and funding. It also supports prospect search to build targeted lists. This streamlines lead enrichment, company intel, and outreach workflows.
How This Skill Works
Install the bundled apollo.py script and provide your Apollo API key via APOLLO_API_KEY. Use commands like enrich, company, search, and bulk-enrich to fetch person or company data or to discover prospects, with options to reveal personal contact info when needed.
When to Use It
- Enrich a contact with email, phone, title, and company data
- Lookup company details like industry, revenue, funding
- Search for prospects by title, domain, or location
- Bulk enrich multiple contacts from a JSON file
- Exclude certain competitors in search results
Quick Start
- Step 1: Obtain your Apollo API key and export APOLLO_API_KEY=your-api-key-here
- Step 2: Run the bundled apollo.py script with a command like enrich, company, search, or bulk-enrich
- Step 3: Review returned data (emails, phones, titles, company data) and use it in your workflows
Best Practices
- Securely store your Apollo API key and export it as APOLLO_API_KEY
- Use --reveal-email and --reveal-phone only when you need personal contact details
- For bulk enrich, prepare a properly structured JSON file and limit to 10 people per call
- Validate and deduplicate returned data before bulk import into downstream systems
- Monitor Apollo credits and check usage in the Apollo settings page
Example Use Cases
- Enrich john@acme.com to fetch email, phone, title, and company data
- Get company info for stripe.com including industry, revenue, and employees
- Find CTOs at fintech companies in NYC
- Bulk enrich this list of contacts from contacts.json
- What is the employee count and revenue for Notion?
