Getting Started with the Easy Email Finder API

Why Use the Easy Email Finder API?

If you are building lead generation tools, CRM integrations, or sales automation workflows, the Easy Email Finder API gives you programmatic access to the same powerful email discovery engine used by thousands of businesses. At just $0.25 per email with no monthly subscription, it is one of the most cost-effective email finder APIs available.

In this guide, you will go from zero to your first successful API call in under 10 minutes. We will cover authentication, endpoints, and practical code examples in cURL, Python, and JavaScript.

Step 1: Create Your Account and Get an API Key

First, sign up at easyemailfinder.com and navigate to the Developer Dashboard. Click "Generate API Key" to create your first key. Your key will start with the prefix eef_live_ followed by 64 hexadecimal characters.

Important: Store your API key securely. It is shown only once at creation time. Treat it like a password and never commit it to version control.

Step 2: Understand the Base URL and Authentication

All API requests go to the base URL:

https://easyemailfinder.com/api/v1

Authentication uses Bearer tokens in the Authorization header:

Authorization: Bearer eef_live_your_api_key_here

Step 3: Make Your First Search

The /search endpoint lets you find businesses by keyword and location using Google Places data. This endpoint is free and does not consume credits.

curl -X POST https://easyemailfinder.com/api/v1/search \
  -H "Authorization: Bearer eef_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "plumbers",
    "location": "Austin, TX",
    "mode": "local"
  }'

The response returns an array of businesses with names, addresses, websites, phone numbers, and Google Places metadata. The mode parameter accepts "local" for brick-and-mortar businesses or "digital" for online businesses and SaaS companies.

Step 4: Enrich Results with Emails

Once you have search results, use the /enrich endpoint to find the email address for a specific business website. This costs 1 credit ($0.25) per successful enrichment.

curl -X POST https://easyemailfinder.com/api/v1/enrich \
  -H "Authorization: Bearer eef_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "website": "https://example-plumbing.com"
  }'

The response includes the discovered email address along with quality signals like tech stack detection, social media links, and franchise indicators.

Step 5: Check Your Credit Balance

Monitor your remaining credits at any time with the free /balance endpoint:

curl https://easyemailfinder.com/api/v1/balance \
  -H "Authorization: Bearer eef_live_your_api_key_here"

Available Endpoints at a Glance

• POST /search - Search for businesses by keyword and location (free)
• POST /enrich - Find the email for a single website (1 credit)
• POST /enrich-batch - Enrich up to 20 websites in one call (1 credit per site)
• POST /search-and-enrich - Search and enrich in a single call, up to 60 results (1 credit per result)
• GET /balance - Check your credit balance (free)
• GET /usage - View your usage history (free)

Python Quickstart

Here is a complete Python example that searches for businesses and enriches the first result:

import requests

API_KEY = "eef_live_your_api_key_here"
BASE_URL = "https://easyemailfinder.com/api/v1"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Step 1: Search for businesses
search_resp = requests.post(f"{BASE_URL}/search", headers=headers, json={
    "query": "plumbers",
    "location": "Austin, TX",
    "mode": "local"
})
businesses = search_resp.json()["results"]

# Step 2: Enrich the first result
if businesses and businesses[0].get("website"):
    enrich_resp = requests.post(f"{BASE_URL}/enrich", headers=headers, json={
        "website": businesses[0]["website"]
    })
    print(enrich_resp.json())

JavaScript / Node.js Quickstart

const API_KEY = "eef_live_your_api_key_here";
const BASE_URL = "https://easyemailfinder.com/api/v1";

async function findLeads() {
  const searchRes = await fetch(`${BASE_URL}/search`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      query: "plumbers",
      location: "Austin, TX",
      mode: "local"
    })
  });
  const { results } = await searchRes.json();

  if (results.length > 0 && results[0].website) {
    const enrichRes = await fetch(`${BASE_URL}/enrich`, {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ website: results[0].website })
    });
    console.log(await enrichRes.json());
  }
}

findLeads();

Next Steps

Now that you have made your first API call, explore more advanced workflows. Learn how to build a lead generation bot or dive into batch enrichment for high-volume prospecting. For complete endpoint documentation, visit the API reference.