A powerful Python tool for extracting and enriching B2B contact information using the Apollo.io API. Perfect for sales teams, recruiters, and marketers looking to build targeted contact lists.

• Smart Contact Discovery - Find executive contacts by company name or domain
• Title-Based Filtering - Prioritize contacts by job titles (Founder, Growth, etc.)
• Email Enrichment - Unlock personal emails when available
• CSV Export - Easy integration with your existing workflow
• Rate Limiting - Built-in rate limiting to respect API usage policies
• Error Handling - Robust error handling and logging
• CLI Interface - Simple command-line interface for easy integration

• Python 3.7 or higher
• Valid Apollo.io API key with sufficient credits

1. Clone the repository:

   git clone https://github.com/sajdakabir/ContactHarvest.git
   cd ContactHarvest

2. Create and activate a virtual environment:

   # On macOS/Linux
   python3 -m venv venv
   source venv/bin/activate
   
   # On Windows
   # python -m venv venv
   # .\venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Configure your Apollo.io API key:

   cp .env.example .env
   # Edit .env and add your API key

Create a .env file in the project root with the following variables:

APOLLO_API_KEY=your_api_key_here

You can modify the following constants in app.py to customize the behavior:

# Preferred job titles (in order of priority)
PREFERRED_TITLES = ["Founder", "Growth"]

# API settings
PER_PAGE = 3        # Number of results per page
MAX_PAGES = 1       # Max pages to fetch per company
SLEEP_SECS = 1      # Delay between API calls (in seconds)

1. Clone the repository:

   git clone <repository-url>
   cd <repository-name>

2. Create and activate a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create a .env file in the project root and add your Apollo.io API key:

   APOLLO_API_KEY=your_apollo_api_key_here

# Process a single company
python app.py input.csv output.csv

# Example with test mode (processes only the first company)
python app.py --test input.csv output.csv

# Show help
python app.py --help

Your input CSV should include these columns:

The generated CSV will contain these columns:

1. Prepare your input CSV (companies.csv):

   company_name,company_website_url
   Google,google.com
   Microsoft,microsoft.com
   

2. Run the script:

   python app.py companies.csv results.csv

3. Check the results (results.csv):

   clutch_profile_url,company_name,company_website,person_name,role,email,linkedin_url
   ,Google,google.com,Sundar Pichai,CEO,[email protected],linkedin.com/in/sundarpichai
   ,Microsoft,microsoft.com,Satya Nadella,CEO,[email protected],linkedin.com/in/satyanadella
   

The script includes built-in rate limiting to prevent hitting Apollo.io's API limits. You can adjust these settings in app.py:

# Adjust these values as needed
PER_PAGE = 3      # Results per page (max 100)
MAX_PAGES = 1     # Pages to fetch per company (set to None for all)
SLEEP_SECS = 1    # Delay between API calls (in seconds)

Modify the PREFERRED_TITLES list in app.py to prioritize different job titles:

PREFERRED_TITLES = [
    "Founder", "CEO", "CTO", "Growth", "Marketing", 
    "Sales", "Business Development", "VP"
]

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the file for details.

• API Credits: Each API call consumes credits from your Apollo.io account
• Rate Limits: Be mindful of Apollo.io's rate limits to avoid temporary bans
• Data Privacy: Ensure compliance with data protection regulations when storing contact information
• Testing: Always test with the --test flag when making changes
• Backup: Keep backups of your input and output files

• Clutch Profile Scraper - Scrape company profiles from Clutch.co
• Apollo.io API Documentation
• Requests Library
• Pandas Documentation

• Built with ❤️ using Python and ☕ coffee
• Thanks to Apollo.io for their powerful API
• Inspired by the need for better sales intelligence tools