# Business Email Enricher - Emails, Phones & Socials (`halvenlabs/business-email-enricher`) Actor Turn a plain list of business website URLs into enriched B2B leads. Visits each site's homepage and contact/about pages to extract email addresses (incl. Cloudflare-obfuscated), phone numbers, and social media profiles — the perfect second step after a Google Maps or directory scraper. - **URL**: https://apify.com/halvenlabs/business-email-enricher.md - **Developed by:** [Halven Labs](https://apify.com/halvenlabs) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 17 total users, 15 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Business Email Enricher — Emails, Phones & Socials from Website URLs Turn a plain list of **business website URLs into enriched B2B leads**. For each site, this actor visits the homepage and its contact/about pages and extracts **email addresses, phone numbers, and social media profiles** (Facebook, X/Twitter, LinkedIn, Instagram, YouTube, TikTok, Pinterest, Telegram, WhatsApp, Discord, Snapchat, Threads, Reddit). The perfect **second step after a Google Maps / directory scraper**: feed in the `website` column, get back contactable leads. Export to **CSV, Excel, JSON, or Google Sheets**. --- ### 🎯 Why use this actor - **Get leads, not just a list of businesses** — turn plain company websites into actual contact points (email, phone, socials) ready for outreach. - **Skip hours of manual "find the contact page" work** — the actor visits contact/about pages for you, across hundreds of sites in one run. - **Drop straight into your existing pipeline** — designed to plug directly into Google Maps / directory scraper output, no reformatting needed. --- ### ✨ Features - **Email extraction that actually works** — finds `mailto:` links, plain-text emails, and even **Cloudflare-obfuscated** addresses. Aggressively filters out junk (image filenames, placeholder/CDN domains). - **Contact & about page crawling** — most emails aren't on the homepage, so the actor automatically follows likely contact/about/impressum pages. - **Social profiles** — first profile URL per network, found in links *and* in JS/JSON blobs, ignoring share/embed noise. - **Phone numbers** — high-precision extraction from `tel:` links. - **Flexible input** — accepts bare domains, full URLs, or objects with a `website`/`url` field (drop-in for Google Maps scraper output). - **Robust** — unreachable sites are recorded (not charged) and never crash the run. - **Bounded** — `maxItems` and `maxPagesPerSite` cap time and cost exactly. --- ### 🚀 Quick start 1. Paste your business website URLs into **Business website URLs**. 2. (Optional) Adjust **Max pages per site** or enable **Only output sites where an email was found**. 3. Click **Start**. The default input runs successfully with zero edits. #### Example input ```json { "websiteUrls": [ "https://acme-plumbing.com", "https://www.example-dentist.com" ], "maxItems": 100, "maxPagesPerSite": 3, "onlyWithEmail": false, "proxyConfiguration": { "useApifyProxy": true } } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `websiteUrls` | array | *(required)* | Website URLs (bare domain, full URL, or objects with a `website`/`url` field). | | `maxItems` | integer | `100` | Max websites to enrich. `0` = no limit. | | `maxPagesPerSite` | integer | `3` | Homepage + up to (this − 1) contact/about pages. | | `onlyWithEmail` | boolean | `false` | Skip (and don't charge for) sites with no email found. | | `proxyConfiguration` | object | Apify Proxy (auto) | Proxy settings. | *** ### 📦 Output One flat row per website: ```json { "inputUrl": "https://www.basecamp.com", "finalUrl": "https://basecamp.com/", "domain": "basecamp.com", "companyName": "Basecamp", "primaryEmail": "jason@basecamp.com", "emails": "jason@basecamp.com, support@basecamp.com", "emailCount": 2, "emailFound": true, "phones": "+1 312-555-0100", "facebook": "https://www.facebook.com/basecamp", "twitter": "https://twitter.com/basecamp", "linkedin": "https://www.linkedin.com/company/basecamp", "instagram": null, "youtube": null, "tiktok": null, "pinterest": null, "telegram": null, "whatsapp": null, "discord": null, "snapchat": null, "threads": null, "reddit": null, "pagesCrawled": 3, "status": "ok" } ``` `status` is `ok` for reachable sites and `unreachable` for sites that failed to load (those rows are **not charged**). #### Output fields | Field | Type | Description | |-------|------|-------------| | `inputUrl` | string | The URL/domain you supplied. | | `finalUrl` | string | null | URL after redirects, when reachable. | | `domain` | string | Bare domain. | | `companyName` | string | null | From `og:site_name` or page title. | | `primaryEmail` | string | null | Best-guess primary contact email. | | `emails` | string | All found emails, comma-separated. | | `emailCount` | number | Count of emails found. | | `emailFound` | boolean | Whether any email was found. | | `phones` | string | Phone number(s) found, comma-separated. | | `facebook` / `twitter` / `linkedin` / `instagram` / `youtube` / `tiktok` / `pinterest` / `telegram` / `whatsapp` / `discord` / `snapchat` / `threads` / `reddit` | string | null | First profile URL per network. | | `pagesCrawled` | number | Pages actually visited for this site. | | `status` | string | `ok` or `unreachable`. | *** ### 💡 Use cases - **Lead generation** — enrich scraped business listings with direct contact details. - **Cold outreach** — build targeted email/social lists for sales and partnerships. - **CRM enrichment** — fill missing contact fields for existing accounts. - **Recruiting & partnerships** — find the right inbox and social profiles fast. *** ### 🔗 Works great with - **Google Maps scrapers** — pipe the `website` field straight in. - **Directory / Yellow Pages scrapers** — enrich any list of company sites. *** ### 💳 Pricing (pay-per-event) | Event | Price | |-------|-------| | Actor start | $0.005 per run | | Website enriched | $0.004 per reachable site | Enriching 1,000 websites costs about **$4.01**. Unreachable sites are recorded free of charge. Set `maxItems` to cap spend. *** ### ❓ FAQ **Why didn't it find an email for some sites?** Many businesses hide emails behind contact forms or images. This actor extracts real, publicly listed addresses (including Cloudflare-protected ones) but can't read data that isn't published as text. **Can I feed in Google Maps scraper output directly?** Yes — pass the objects (it reads the `website`/`url` field) or just the website strings. **How do I get more emails per site?** Increase `maxPagesPerSite` so the actor crawls more contact/about pages. *** ### ⚖️ Legal This actor collects only publicly available business contact information from public web pages. You are responsible for using the data in compliance with applicable laws (including GDPR, CAN-SPAM, and local anti-spam rules) and each website's terms. Do not use extracted emails for unsolicited bulk messaging where prohibited. # Actor input Schema ## `websiteUrls` (type: `array`): List of business website URLs to enrich (e.g. the 'website' column from a Google Maps scraper export). The actor visits each site's homepage plus likely contact/about pages and extracts emails, phone numbers, and social links. ## `maxItems` (type: `integer`): Maximum number of websites to enrich in this run (the input list is capped to this many sites). Use 0 for no limit. Note: with 'Only with email' enabled, the run can return fewer rows than this, since sites without an email are crawled but not output. ## `maxPagesPerSite` (type: `integer`): How many pages to visit per website: the homepage plus up to (this minus one) contact/about pages. Higher finds more emails but costs more time. 3 is a good balance. ## `onlyWithEmail` (type: `boolean`): If enabled, sites where no email could be found are skipped (and not charged). If disabled (default), every reachable site produces a row with whatever contact data was found. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Proxy (auto) is recommended and enabled by default to avoid rate limits and geo-blocks. ## Actor input object example ```json { "websiteUrls": [ "https://acme-plumbing.com", "https://www.example-dentist.com" ], "maxItems": 100, "maxPagesPerSite": 3, "onlyWithEmail": false, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): One flat row per website: emails, phones, and social profiles found. # 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 = { "websiteUrls": [ "https://www.basecamp.com", "https://www.patagonia.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("halvenlabs/business-email-enricher").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 = { "websiteUrls": [ "https://www.basecamp.com", "https://www.patagonia.com", ] } # Run the Actor and wait for it to finish run = client.actor("halvenlabs/business-email-enricher").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 '{ "websiteUrls": [ "https://www.basecamp.com", "https://www.patagonia.com" ] }' | apify call halvenlabs/business-email-enricher --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=halvenlabs/business-email-enricher", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Business Email Enricher - Emails, Phones & Socials", "description": "Turn a plain list of business website URLs into enriched B2B leads. Visits each site's homepage and contact/about pages to extract email addresses (incl. Cloudflare-obfuscated), phone numbers, and social media profiles — the perfect second step after a Google Maps or directory scraper.", "version": "1.1", "x-build-id": "UFKSNgTcusK7zRdf0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/halvenlabs~business-email-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-halvenlabs-business-email-enricher", "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/halvenlabs~business-email-enricher/runs": { "post": { "operationId": "runs-sync-halvenlabs-business-email-enricher", "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/halvenlabs~business-email-enricher/run-sync": { "post": { "operationId": "run-sync-halvenlabs-business-email-enricher", "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": [ "websiteUrls" ], "properties": { "websiteUrls": { "title": "Business website URLs", "type": "array", "description": "List of business website URLs to enrich (e.g. the 'website' column from a Google Maps scraper export). The actor visits each site's homepage plus likely contact/about pages and extracts emails, phone numbers, and social links.", "items": { "type": "string" } }, "maxItems": { "title": "Max websites", "minimum": 0, "type": "integer", "description": "Maximum number of websites to enrich in this run (the input list is capped to this many sites). Use 0 for no limit. Note: with 'Only with email' enabled, the run can return fewer rows than this, since sites without an email are crawled but not output.", "default": 100 }, "maxPagesPerSite": { "title": "Max pages per site", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages to visit per website: the homepage plus up to (this minus one) contact/about pages. Higher finds more emails but costs more time. 3 is a good balance.", "default": 3 }, "onlyWithEmail": { "title": "Only output sites where an email was found", "type": "boolean", "description": "If enabled, sites where no email could be found are skipped (and not charged). If disabled (default), every reachable site produces a row with whatever contact data was found.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy (auto) is recommended and enabled by default to avoid rate limits and geo-blocks.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```