# Reverse Email Lookup (`companyenrich/reverse-email-lookup`) Actor Resolve professional profiles and current company data from email addresses. - **URL**: https://apify.com/companyenrich/reverse-email-lookup.md - **Developed by:** [companyenrich](https://apify.com/companyenrich) (community) - **Categories:** Agents, Lead generation - **Stats:** 8 total users, 2 monthly users, 2.9% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 reverse-email-lookups This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ### What does CompanyEnrich Reverse Email Lookup do? **CompanyEnrich Reverse Email Lookup** resolves professional profiles by email address. Enter one email or a list of emails, and the Actor returns matched profile data, current company details, credit metadata, and the full CompanyEnrich person object. The Actor is built for users who want reverse email enrichment through Apify schedules, datasets, webhooks, integrations, and no-code automations. Users run the Actor with email inputs only. ### Why use CompanyEnrich Reverse Email Lookup? Use this Actor for form enrichment, CRM completion, lead routing, account qualification, fraud or suspicious-domain checks, and workflows that start from a known work email address. CompanyEnrich is an API-first B2B data platform for platforms, AI agents, RevOps teams, and GTM workflows. Reverse email lookup resolves the company from the email domain and returns the best deterministic person match when found. ### How to use CompanyEnrich Reverse Email Lookup 1. Open the Actor in Apify Console. 2. Enter one email in `email`, or add multiple emails in `emails`. 3. Click **Start**. 4. Download results from the default dataset as JSON, CSV, Excel, HTML, or through the Apify API. ### Input | Field | Type | Description | | -------------------- | ------------ | ------------------------------------------------------------------------------------------ | | `email` | string | One email address to resolve. | | `emails` | string array | Optional list of additional email addresses. | | `requestTimeoutSecs` | integer | Maximum time to wait for each CompanyEnrich API request. Default: `30`. | | `maxRetries` | integer | Retry count for network errors, rate limits, and transient API errors. Default: `2`. | | `failOnError` | boolean | If enabled, the run fails after pushing error rows when any lookup fails. Default: `true`. | Example input: ```json { "email": "jane@example.com", "emails": ["john@example.com"] } ```` ### Output The Actor writes one item per email to the default dataset. You can download the dataset in JSON, CSV, Excel, HTML, or access it through the Apify API. Example successful dataset item: ```json { "status": "success", "email": "jane@example.com", "httpStatus": 200, "name": "Jane Doe", "position": "VP Sales", "seniority": "vp", "department": "sales", "linkedinUrl": "https://www.linkedin.com/in/example", "country": "United States", "currentCompanyName": "Example Inc.", "currentCompanyDomain": "example.com", "creditCost": 5, "person": { "id": 123, "name": "Jane Doe" } } ``` Example error dataset item: ```json { "status": "error", "email": "missing@example.com", "httpStatus": 404, "errorMessage": "CompanyEnrich API returned HTTP 404 Not Found.", "errorBody": { "title": "Not Found" } } ``` The default key-value store also contains an `OUTPUT` summary record with total emails, successful lookups, failed lookups, charged events, and failed emails. ### Pricing and usage This Actor uses Apify pay-per-event pricing. One `reverse-email-lookup` event is charged for each email lookup when pay-per-event pricing is active. The final Apify cost depends on the number of emails you submit and the price shown in Apify Console. CompanyEnrich documents `POST /people/lookup` as costing 5 credits per successful call. ### Tips and advanced options - Use work emails when possible. CompanyEnrich resolves the company from the email domain first. - Duplicate emails are removed after normalization. - Keep `failOnError` enabled if failed lookups should fail automation workflows. - Disable `failOnError` if you prefer completed runs with error rows in the dataset. - Use Apify schedules, webhooks, integrations, and API access to connect lookup results to downstream workflows. ### FAQ, disclaimers, and support **Does this Actor scrape websites?**\ No. It calls the CompanyEnrich REST API and stores the API response in Apify datasets. **Where can I get help?**\ Use the Actor Issues tab in Apify Console for bugs, field requests, or integration questions. Learn more about CompanyEnrich at https://companyenrich.com. # Actor input Schema ## `email` (type: `string`): Single email address to resolve. ## `emails` (type: `array`): Optional list of additional email addresses to resolve. ## `requestTimeoutSecs` (type: `integer`): Maximum time to wait for each CompanyEnrich API request. ## `maxRetries` (type: `integer`): Retry count for transient network failures, 429 responses, and 5xx responses. ## `failOnError` (type: `boolean`): When enabled, the Actor pushes error rows to the dataset and then fails the run if any lookup failed. ## Actor input object example ```json { "email": "jane@example.com", "emails": [], "requestTimeoutSecs": 30, "maxRetries": 2, "failOnError": true } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `summary` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "email": "jane@example.com" }; // Run the Actor and wait for it to finish const run = await client.actor("companyenrich/reverse-email-lookup").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "email": "jane@example.com" } # Run the Actor and wait for it to finish run = client.actor("companyenrich/reverse-email-lookup").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 '{ "email": "jane@example.com" }' | apify call companyenrich/reverse-email-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=companyenrich/reverse-email-lookup", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reverse Email Lookup", "description": "Resolve professional profiles and current company data from email addresses.", "version": "0.1", "x-build-id": "MzcSiuqfImq2PdYyG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/companyenrich~reverse-email-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-companyenrich-reverse-email-lookup", "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/companyenrich~reverse-email-lookup/runs": { "post": { "operationId": "runs-sync-companyenrich-reverse-email-lookup", "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/companyenrich~reverse-email-lookup/run-sync": { "post": { "operationId": "run-sync-companyenrich-reverse-email-lookup", "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", "properties": { "email": { "title": "Email", "type": "string", "description": "Single email address to resolve." }, "emails": { "title": "Emails", "type": "array", "description": "Optional list of additional email addresses to resolve.", "items": { "type": "string" }, "default": [] }, "requestTimeoutSecs": { "title": "Request timeout seconds", "minimum": 1, "type": "integer", "description": "Maximum time to wait for each CompanyEnrich API request.", "default": 30 }, "maxRetries": { "title": "Max retries", "minimum": 0, "type": "integer", "description": "Retry count for transient network failures, 429 responses, and 5xx responses.", "default": 2 }, "failOnError": { "title": "Fail run on API errors", "type": "boolean", "description": "When enabled, the Actor pushes error rows to the dataset and then fails the run if any lookup failed.", "default": true } } }, "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 } } } } } } } } } } ```