Skip to content

Latest commit

 

History

History
51 lines (35 loc) · 2.18 KB

readme.md

File metadata and controls

51 lines (35 loc) · 2.18 KB

Bulk Email Finder

Build Status

Find email addresses of people in bulk by providing a list of companies. Made using Hunter.io's API.

Steps to use the app

  • Clone the repo.
  • Install the required packages using:
npm install
  • Run the following command:
node app.js
  • Visit http://localhost:4000.

  • Paste your API key from Hunter.io. For detailed steps, please see the next section.

    Homepage

  • Upload your CSV. Please ensure that your entries are in a single column, as shown in the example below.

Input CSV

  • Submit the form and click on the download button.

Download

This is how the downloaded CSV might look like:

Output_CSV

Steps to get Hunter.io's API key

  • Login or Signup on Hunter.io.
  • Visit hunter.io/api_keys.
  • Copy the API key.

Please note that the free version of Hunter.io allows only up to 50 API calls per month.

Important Notes

  • The app takes in a CSV with a single column that has names of companies in it, and returns a CSV with a list that has emails which:

    1. Belong to humans, and are not generic (for instance, it will never return [email protected], or [email protected]. Edge cases yet to be tested).
    2. Have the most probability of being correct. For best results, it's limited to return only two entries with good confidence score, per company.
  • Sometimes, the app might download an empty sheet, or would miss some entries. This might be because:

    1. Hunter.io does not have any contacts for that company
    2. Hunter.io has only generic contacts for that company
  • This version of the app outputs the email, first name (if available) and position (if available) of the fetched contact. Other required information could be found in the body of the request.