easy-email-finder

# 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.

```
Authorization: Bearer $EEF_API_KEY
```

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

## Base URL

```
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: ap...