apollo

name	apollo
description	"Search for leads and enrich company data using Apollo.io — find companies, domains, LinkedIn profiles, phone numbers, and industry info"

Apollo

Search for leads and enrich company data using Apollo.io.

Recommended Workflow for Lead Generation

1. search_people with keywords, person_titles, person_locations, organization_num_employees_ranges to find people at matching companies — returns person IDs and company domains.
2. If the Hunter tool is available: use Hunter email_finder with first_name + last_name + domain to find emails (cheaper and faster than Apollo enrich). Use Hunter email_verifier to verify before outreach.
3. If Hunter is NOT available: use Apollo enrich_person with person_id from search results to get emails.
4. Optionally use search_organizations to find companies first, then enrich_organization for deeper details.

IMPORTANT: Apollo search results are previews — they do NOT include emails. You MUST use Hunter (preferred) or Apollo enrich_person to get email addresses.

When to use Apollo vs Hunter

• Apollo: searching for leads (search_people, search_organizations), enriching company data (enrich_organization), getting full person profile when Hunter has no result.
• Hunter: finding emails (email_finder), verifying emails (email_verifier), finding all emails at a domain (domain_search). Hunter is specialized for email discovery and is more accurate for this purpose.
• Rule: If you have a person's name and company domain, try Hunter email_finder FIRST. Only fall back to Apollo enrich_person if Hunter returns no result.

Be Proactive

• When the user asks for "leads" or "contacts" or "emails", immediately search and enrich — do NOT ask for clarification on titles. Use common decision-maker titles: CEO, Founder, Owner, President, CMO, VP of Marketing, Director of Marketing, Head of Growth.
• When the user says "all" for titles, use the common titles above.
• After search_people returns results, IMMEDIATELY use Hunter email_finder (if available) or Apollo enrich_person for each person to get their email. Do not stop after search — the user wants contact details.
• Process multiple enrichments in sequence without asking permission.

Company Search & Enrichment

• search_organizations — Search Apollo's database of companies. Filter by organization_name, keywords, locations, organization_num_employees_ranges. Returns: company name, website domain, LinkedIn URL, phone, revenue.
• enrich_organization — Get full details for a company by domain. Returns: all company data plus industry, employee count, founded year, description, technologies, social URLs.

People Search & Enrichment

• search_people — Search for people by person_titles, person_locations, organization_domains, organization_num_employees_ranges, keywords. Returns names and titles (emails may be obfuscated — use enrich_person for full data).
• enrich_person — Get full contact details by person_id (from search_people), email, linkedin_url, or first_name+last_name+organization_name/domain. Returns: verified email, phone, title, company, LinkedIn. Requires a Master API key.

Example: Full lead generation flow

Step 1: action: search_people
        person_titles: "CEO,Founder,Owner,VP of Marketing"
        keywords: "digital marketing agency"
        person_locations: "United States"
        organization_num_employees_ranges: "11,50"
        per_page: 10

Step 2: For each person in results, call:
        action: enrich_person
        person_id: "<id from search results>"

This gives you: full name, verified email, phone, LinkedIn, title, company.

Example: Enrich a company for outreach

action: enrich_organization
domain: "webfx.com"

Example: Find a person's contact info

action: enrich_person
first_name: "John"
last_name: "Smith"
domain: "webfx.com"