How to Use the Search-and-Enrich Endpoint for Maximum Efficiency

One Call to Rule Them All

The standard workflow with the Easy Email Finder API involves two steps: search for businesses with /search, then enrich each result with /enrich or /enrich-batch. The /search-and-enrich endpoint combines both into a single API call, returning businesses complete with their email addresses.

When to Use Search-and-Enrich

This endpoint is ideal when you want to go from a keyword and location directly to enriched leads without intermediate processing. Use it when:

• You want the simplest possible integration with minimal code
• You do not need to filter or inspect search results before enrichment
• You are building a one-shot lead generation workflow
• You want to reduce the number of API round-trips

If you need to filter search results before enriching (for example, only enriching businesses with websites that match certain criteria), stick with separate /search and /enrich-batch calls.

Endpoint Details

POST https://easyemailfinder.com/api/v1/search-and-enrich

{
  "query": "plumbers",
  "location": "Austin, TX",
  "mode": "local"   // or "digital" for online businesses
}

// Response
{
  "results": [
    {
      "name": "Austin Premier Plumbing",
      "address": "123 Main St, Austin, TX 78701",
      "phone": "(512) 555-0123",
      "website": "https://austinpremierplumbing.com",
      "email": "contact@austinpremierplumbing.com",
      "googleRating": 4.8,
      "reviewCount": 142,
      "types": ["plumber", "home_goods_store"],
      "businessStatus": "OPERATIONAL"
    }
    // ... up to 60 results
  ],
  "creditsUsed": 18,
  "creditsRemaining": 482
}

The endpoint supports up to 60 results per call. Each result with a discovered email costs 1 credit ($0.25). Results without emails do not consume credits.

The mode Parameter

The mode parameter controls how the API searches for businesses:

• "local" - Optimized for brick-and-mortar businesses. Searches Google Places for physical locations like restaurants, dentists, plumbers, and retail stores.
• "digital" - Optimized for online businesses. Finds SaaS companies, digital agencies, e-commerce stores, and other businesses that may not have a physical storefront.

Learn more about digital mode in our dedicated digital search mode guide.

cURL Example

curl -X POST https://easyemailfinder.com/api/v1/search-and-enrich \
  -H "Authorization: Bearer eef_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "yoga studios",
    "location": "San Francisco, CA",
    "mode": "local"
  }'

Python Example

import requests

API_KEY = "eef_live_your_api_key_here"
BASE = "https://easyemailfinder.com/api/v1"

resp = requests.post(f"{BASE}/search-and-enrich", headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}, json={
    "query": "yoga studios",
    "location": "San Francisco, CA",
    "mode": "local"
})

data = resp.json()
for lead in data["results"]:
    if lead.get("email"):
        print(f"{lead['name']}: {lead['email']}")

print(f"\nCredits used: {data['creditsUsed']}")
print(f"Credits remaining: {data['creditsRemaining']}")

Node.js Example

const API_KEY = "eef_live_your_api_key_here";

async function searchAndEnrich(query, location, mode = "local") {
  const resp = await fetch("https://easyemailfinder.com/api/v1/search-and-enrich", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ query, location, mode })
  });

  const data = await resp.json();
  console.log(`Found ${data.results.length} results, used ${data.creditsUsed} credits`);

  return data.results.filter(r => r.email);
}

const leads = await searchAndEnrich("yoga studios", "San Francisco, CA");
console.log(leads);

Cost Comparison: Two-Step vs. Search-and-Enrich

Both approaches cost the same in terms of credits. The /search endpoint is free, and enrichment is 1 credit per email regardless of which endpoint you use. The difference is purely in convenience and the number of HTTP requests.

• Two-step approach: 1 search call + N/20 batch enrich calls (where N is the number of websites)
• Search-and-enrich: 1 call total

For a typical search returning 20 results, the two-step approach requires 2 API calls while search-and-enrich requires just 1. The time savings add up when you are running searches across many keyword-location pairs.

Limitations

The search-and-enrich endpoint processes results sequentially, so it can take 30-60 seconds for large result sets. If you are building a real-time UI, consider using /search first to display results immediately, then /enrich-batch to add emails asynchronously.

Next Steps

Now that you understand the search-and-enrich endpoint, try building a lead generation bot that uses it for the simplest possible implementation. For complete API documentation, visit the developer docs.