Apollo.io Enrichment

Apollo.io contact and company enrichment API. Enrich people with email, phone, title, company data. Enrich organizations with industry, revenue, employee count, funding. Search for prospects. Use when the user needs to enrich contacts, find emails, lookup company info, or search for leads.

Security Scan

The skill implements exactly the Apollo enrichment functionality described, but the package metadata fails to declare the required APOLLO_API_KEY credential (a meaningful mismatch) and the source is unknown — review before installing.

Purpose & Capability

The name/description, SKILL.md, and included apollo.py are coherent: the code talks to api.apollo.io and implements person/company enrichment and search. However, the registry metadata claims no required environment variables or primary credential while both SKILL.md and the code require the APOLLO_API_KEY environment variable — an inconsistency between what the skill says it needs and what it actually requires.

Instruction Scope

SKILL.md and apollo.py keep scope to Apollo API calls. The script only reads a user-supplied JSON file for bulk enrich and the APOLLO_API_KEY env var; it does not attempt to read other system files, sweep environment variables, or post data to any endpoint other than api.apollo.io. Filtering and formatting are local. No vague instructions granting broad discretionary access are present.

Install Mechanism

There is no install spec; this is instruction + bundled script. That minimizes install-time risk because nothing is downloaded or extracted at install time.

Credentials

The code requires a secret APOLLO_API_KEY (sourced from the APOLLO_API_KEY environment variable) which is appropriate for this integration. However, the skill's registry metadata does not declare that required environment variable or a primary credential — this mismatch is a red flag (could be an oversight or bad packaging). Apart from that single key, no other secrets are requested, which is proportionate for the stated purpose. Note also that using the key causes the skill to transmit contact/company data to Apollo's servers, so privacy/consent and billing/credits should be considered.

Persistence & Privilege

The skill does not request persistent or elevated platform privileges (always=false). It does not modify other skills or system-wide config. It runs as a user-invoked CLI script and can be invoked autonomously by the agent (the platform default), which is expected for skills.

What to consider before installing

Before installing or enabling this skill, note the main inconsistency: the code and SKILL.md require APOLLO_API_KEY but the registry metadata does not declare it. Ask the publisher to update the metadata to explicitly require APOLLO_API_KEY so you can see what secrets the skill needs. Treat the API key as sensitive — grant a key with minimal scope, monitor its usage, and avoid sending highly sensitive personal data without consent (the skill transmits contact data to api.apollo.io). Because the source/publisher is unknown, consider testing in an isolated environment, reviewing the included apollo.py yourself (it calls only api.apollo.io), and checking your Apollo account for unexpected usage/charges. If you accept the risk, provide only the API key the skill needs (no broader credentials) and verify that the key's permissions and your privacy/consent posture are appropriate.

Apollo Enrichment Skill

Enrich contacts and companies using Apollo.io API.

Setup

1. Get your API key from Apollo Settings
2. 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 "[e-mail]"

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

# Include personal email & phone
python3 apollo.py enrich --email "[e-mail]" --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": "[e-mail]"},
  {"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-competitors or -x — Automatically filters out employees from Hathora, Edgegap, and Nakama (Heroic Labs)

Example Prompts

• "Enrich [e-mail] 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.