# 🏢 Domain Email Finder ⚡ Find Business Emails by Company Domain (`vulnv/domain-email-finder`) Actor

Find business email addresses and contacts for a list of company domains. Enter domains, choose the roles you want, and get verified emails in bulk with automatic batching and rate-limit retries.

- **URL**: https://apify.com/vulnv/domain-email-finder.md
- **Developed by:** [VulnV](https://apify.com/vulnv) (community)
- **Categories:** Lead generation, Business
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$30.00 / 1,000 contact founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 🏢 Domain Email Finder ⚡ Find Business Emails by Company Domain

### Overview
The **Domain Email Finder** is an Apify Actor that finds business email addresses and contacts for a list of company domains. Provide the domains you care about, pick the roles you want to reach, and get verified business emails in bulk. Perfect for lead generation, sales outreach, and contact enrichment.

✅ Bulk domain lookup | ✅ Role targeting | ✅ Automatic batching | ✅ Rate-limit retries | ✅ Clean JSON output

---

#### **Features**
- **Domain-to-Email Discovery** — Find business emails for any company from its domain
- **Role Targeting** — Focus on the people who matter (CEO, Founder, Owner, and more)
- **Bulk Processing** — Feed in a whole list of domains in one run
- **Automatic Batching** — Domains are processed in batches with controlled concurrency
- **Rate-Limit Retries** — Automatic exponential-backoff retries when limits are hit
- **Clean Results** — Structured JSON output with clear success/failure indicators

---

### 🧾 Input Configuration

Submit an array of company domains and (optionally) the roles you want to reach:

```json
{
  "domains": [
    "stripe.com",
    "airbnb.com"
  ],
  "roles": ["CEO", "Founder", "Owner"],
  "maxResults": 5
}
````

- **domains** (required) — bare domains (`example.com`) or full URLs both work.
- **roles** (optional) — up to 3 target job roles. Defaults to `CEO, Founder, Owner`.
- **maxResults** (optional) — cap on contacts returned per run. Defaults to 5.

> ℹ️ A paid Apify plan is required to return results. On the free plan a run completes successfully but returns 0 contacts.

***

### 📤 Output Format

Each discovered contact becomes one dataset item:

#### Contact Found:

```json
{
  "query_domain": "stripe.com",
  "found": true,
  "email": "person@stripe.com",
  "name": "Jane Doe",
  "role": "Founder",
  "domain": "stripe.com"
}
```

#### No Contact Found:

```json
{
  "query_domain": "example.com",
  "found": false,
  "error": "No contacts found for this domain."
}
```

***

### 📊 Output & Export

#### **Dataset Storage**

- All results are stored in your Apify dataset
- Each discovered contact becomes one dataset item
- Domains with no contact are clearly marked with `found: false`

#### **Export Formats**

- **JSON** — Raw structured data for API integration
- **CSV** — Spreadsheet-compatible format
- **Excel** — Formatted spreadsheet

***

### 💼 Common Use Cases

#### **Lead Generation & Sales**

- Turn a list of target companies into a list of contactable business emails
- Enrich account lists with decision-maker contact details
- Build outreach lists for cold email campaigns

#### **Recruitment & Talent Sourcing**

- Reach hiring managers and founders at target companies directly

#### **Marketing & Partnerships**

- Connect with the right people at companies you want to work with

#### **CRM Data Enrichment**

- Fill in missing contact emails for accounts in your CRM

***

### ⚠️ Important Notes

- Email availability depends on data coverage — not every domain returns a contact
- Only the first 3 roles are used per run
- The actor batches requests and retries automatically when rate limits are reached

***

### 🚀 Getting Started

1. **Add company domains** to the input
2. **Choose target roles** (or keep the defaults)
3. **Run the Actor**
4. **Download Results** from the dataset in your preferred format

***

📬 **Custom fields, higher volume, or a managed data pipeline?** Email us at <apify@vulnv.com> — we build bespoke scrapers and managed feeds for teams. Questions and feature requests welcome too, or visit our [Apify profile](https://apify.com/vulnv).

# Actor input Schema

## `domains` (type: `array`):

Enter the company domains you want to find business email contacts for. You can paste bare domains (example.com) or full URLs - both work.

## `roles` (type: `array`):

The job roles you want contacts for (up to 3). Only the first 3 are used. Leave empty to use sensible decision-maker defaults (CEO, Founder, Owner).

## `maxResults` (type: `integer`):

Maximum number of contacts to return in this run. Defaults to 5. A paid Apify plan is required to return results.

## Actor input object example

```json
{
  "domains": [
    "stripe.com",
    "airbnb.com"
  ],
  "roles": [
    "CEO",
    "Founder",
    "Owner"
  ],
  "maxResults": 5
}
```

# Actor output Schema

## `results` (type: `string`):

Domain email finder results stored in the default dataset.

## `overview` (type: `string`):

Overview table view of discovered contacts.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "domains": [
        "stripe.com",
        "airbnb.com"
    ],
    "roles": [
        "CEO",
        "Founder",
        "Owner"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("vulnv/domain-email-finder").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "domains": [
        "stripe.com",
        "airbnb.com",
    ],
    "roles": [
        "CEO",
        "Founder",
        "Owner",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("vulnv/domain-email-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "domains": [
    "stripe.com",
    "airbnb.com"
  ],
  "roles": [
    "CEO",
    "Founder",
    "Owner"
  ]
}' |
apify call vulnv/domain-email-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=vulnv/domain-email-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🏢 Domain Email Finder ⚡ Find Business Emails by Company Domain",
        "description": "Find business email addresses and contacts for a list of company domains. Enter domains, choose the roles you want, and get verified emails in bulk with automatic batching and rate-limit retries.",
        "version": "1.0",
        "x-build-id": "KDOBZBNvB6CyU1poK"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/vulnv~domain-email-finder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-vulnv-domain-email-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/vulnv~domain-email-finder/runs": {
            "post": {
                "operationId": "runs-sync-vulnv-domain-email-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/vulnv~domain-email-finder/run-sync": {
            "post": {
                "operationId": "run-sync-vulnv-domain-email-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "domains"
                ],
                "properties": {
                    "domains": {
                        "title": "🌐 Company Domains",
                        "type": "array",
                        "description": "Enter the company domains you want to find business email contacts for. You can paste bare domains (example.com) or full URLs - both work.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "roles": {
                        "title": "🎯 Target Roles",
                        "type": "array",
                        "description": "The job roles you want contacts for (up to 3). Only the first 3 are used. Leave empty to use sensible decision-maker defaults (CEO, Founder, Owner).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of contacts to return in this run. Defaults to 5. A paid Apify plan is required to return results.",
                        "default": 5
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```