Openclaw Skill

Search for local or digital businesses and enrich them with verified email addresses, tech stack detection, and social media links using the Easy Email Finder API.

Easy Email Finder API

Use this skill to find business leads and their email addresses. The Easy Email Finder API lets you search for local businesses (via Google Places) or digital/online-only businesses (SaaS, agencies, e-commerce, etc.), then enrich them with verified emails scraped from their websites.

Authentication

All requests require a Bearer token. The API key is available in the EEF_API_KEY environment variable.

text

Authorization: Bearer $EEF_API_KEY

Get an API key at https://easyemailfinder.com/developer

Base URL

text

https://easyemailfinder.com/api/v1

Endpoints

Search for businesses (free — no credits)

bash

# Local businesses (default)
curl -X POST https://easyemailfinder.com/api/v1/search \
  -H "Authorization: Bearer $EEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "dentists in denver", "pageToken": null}'

# Digital/online-only businesses
curl -X POST https://easyemailfinder.com/api/v1/search \
  -H "Authorization: Bearer $EEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "SaaS companies", "mode": "digital"}'

Set mode to "local" (default) for Google Places results or "digital" for online-only businesses. Returns business names, websites, and (for local mode) addresses, phone numbers, ratings, and Google Maps links. Use pageToken from the response to get the next page.

Enrich a website with emails (1 credit per call)

bash

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

Returns: emails, techStack (wordpress/shopify/wix/squarespace/webflow/custom), socialLinks (facebook, instagram, linkedin, twitter, youtube, tiktok).

Batch enrich (1 credit per website, max 20)

bash

curl -X POST https://easyemailfinder.com/api/v1/enrich-batch \
  -H "Authorization: Bearer $EEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"websites": ["https://site1.com", "https://site2.com"]}'

Search + enrich in one call (1 credit per result)

bash

# Local businesses
curl -X POST https://easyemailfinder.com/api/v1/search-and-enrich \
  -H "Authorization: Bearer $EEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "plumbers in austin", "limit": 20}'

# Digital businesses
curl -X POST https://easyemailfinder.com/api/v1/search-and-enrich \
  -H "Authorization: Bearer $EEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "digital marketing agencies", "limit": 20, "mode": "digital"}'

Combines search and enrichment. limit defaults to 20, max 60. Supports mode: "local" (default) or "digital".

Check credit balance (free)

bash

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

View usage stats (free)

bash

curl "https://easyemailfinder.com/api/v1/usage?days=7" \
  -H "Authorization: Bearer $EEF_API_KEY"

Response Format

All responses follow this envelope:

json

{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "creditsUsed": 1,
    "remainingCredits": 94.75
  }
}

Errors:

json

{
  "error": { "code": "INSUFFICIENT_CREDITS", "message": "..." },
  "meta": { "requestId": "req_abc123" }
}

Rate Limits

• Standard endpoints (search, balance, usage): 120 requests/minute
• Enrich endpoints: 30 requests/minute
• When rate limited, check the Retry-After response header

Credit Costs

Endpoint	Cost
/v1/search	Free
/v1/enrich	1 credit ($0.25)
/v1/enrich-batch	1 credit per website
/v1/search-and-enrich	1 credit per result
/v1/balance	Free
/v1/usage	Free

Typical Workflow

Local businesses (e.g. "dentists in denver"):

1. Use /v1/search to find businesses in a specific industry and location
2. Use /v1/enrich or /v1/enrich-batch to get emails for businesses with websites
3. Or use /v1/search-and-enrich to do both in one call

Digital businesses (e.g. "SaaS companies", "digital marketing agencies"):

1. Use /v1/search with "mode": "digital" to find online-only businesses
2. Enrich with /v1/enrich or use /v1/search-and-enrich with "mode": "digital"

Check /v1/balance to monitor credit usage.