apollo-cli

CLI for Apollo.io prospect search, people enrichment, and lead list management.

Prerequisites

• Node.js 18+
• Apollo.io API key (get from Apollo Settings → Integrations → API)

Setup

cd ~/tools/apollo-cli
npm install
npm run build
npm link

# Add your API key to ~/tools/.env:
echo "APOLLO_API_KEY=your-key-here" >> ~/tools/.env

Usage

Account Info

apollo-cli me

People Search

# Search by title and location
apollo-cli people search --titles "Event Planner" --location "Dallas, Texas" --limit 5

# Search with multiple filters
apollo-cli people search \
  --titles "Event Planner,Event Coordinator" \
  --seniority "manager,director" \
  --company-size "51,200" \
  --limit 25

# Include personal emails and phone numbers
apollo-cli people search --titles "CTO" --reveal-personal-emails --reveal-phones

People Enrichment

# Enrich by email
apollo-cli people enrich --email "jane@acme.com"

# Enrich by name + domain
apollo-cli people enrich --first-name "Jane" --last-name "Doe" --domain "acme.com"

# Bulk enrich (up to 10 emails)
apollo-cli people bulk-enrich --emails "a@acme.com,b@acme.com"

# Get by Apollo ID
apollo-cli people get 60f1a2b3c4d5e6f7a8b9c0d1

Organization Search & Enrichment

apollo-cli orgs search --name "Hilton" --limit 5
apollo-cli orgs enrich --domain "hilton.com"

Lists

apollo-cli lists                                    # List all
apollo-cli lists create --name "Q1 Event Planners"  # Create
apollo-cli lists contacts <list_id> --limit 50      # Get contacts in list

Contacts (CRM)

apollo-cli contacts search --q "Jane" --limit 10
apollo-cli contacts create --email "jane@acme.com" --first-name "Jane" --last-name "Doe"

Sequences

apollo-cli sequences list
apollo-cli sequences get <sequence_id>
apollo-cli sequences add-contacts <sequence_id> --contact-ids "id1,id2,id3"

Output Format

All commands output JSON to stdout:

{"ok": true, "data": {"people": [...], "pagination": {...}}}

Use --pretty for formatted output. Pipe to jq for filtering:

apollo-cli people search --titles "CTO" --limit 5 | jq '.data.people[].name'

Notes

• Credits: People search and enrichment consume Apollo credits. The credits_consumed field is included in responses when available.
• Rate limits: Apollo returns 429 with Retry-After header when rate limited. The CLI reports this in the error message.
• Pagination: Max 100 results per page, up to 500 pages. Use --page and --limit flags.
• Master key: people search requires a master API key. Regular keys only work for enrichment.

Reference

• Apollo API docs
• People search
• People enrichment
• Organization enrichment