# Contact Details Scraper (`automly/contact-details-scraper`) Actor

Extract emails, phone numbers, WhatsApp links, social media profiles, and contact page URLs from any list of websites. Crawls internal pages, deduplicates results per domain, and exports to JSON, CSV, or Excel. Built for lead generation, CRM enrichment, and sales prospecting.

- **URL**: https://apify.com/automly/contact-details-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.25 / 1,000 contacts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contact Details Scraper

### 📇 What does Contact Details Scraper do?

**Contact Details Scraper** crawls any list of websites and extracts **email addresses**, **phone numbers**, **WhatsApp links**, **social media profiles** (LinkedIn, Facebook, Instagram, X/Twitter, YouTube, TikTok), and **contact page URLs** into one clean, deduplicated dataset. Give it a homepage and it follows internal links — contact, about, team, and support pages — down to a crawl depth you choose, so it picks up the details that sit two clicks deep, not just what happens to be in the footer of the front page.

It is built for **lead generation**, **CRM enrichment**, and **sales prospecting**:

- Extract every public way to reach a business, with the exact page and surrounding text where each detail was found
- Crawl hundreds of websites in one run — each website's contacts appear in the dataset as soon as it is done
- Get one clean row per contact detail, deduplicated per domain, ready for a spreadsheet or CRM import
- Export as **JSON, CSV, Excel, XML, or HTML**, or push results to Google Sheets, Zapier, Make, and webhooks
- Run on demand, on a schedule, or from your own code via the API

### 🧲 What data can I extract?

<table>
<tr>
<td>📧 Email addresses (text + mailto: links)</td>
<td>📞 Phone numbers (text + tel: links)</td>
<td>💬 WhatsApp links with phone numbers</td>
</tr>
<tr>
<td>💼 LinkedIn profiles</td>
<td>📘 Facebook pages/profiles</td>
<td>📸 Instagram profiles</td>
</tr>
<tr>
<td>🐦 X/Twitter handles</td>
<td>▶️ YouTube channels</td>
<td>🎵 TikTok profiles</td>
</tr>
<tr>
<td>📄 Contact & about page URLs</td>
<td>🏷 Page title + text context per match</td>
<td>🔁 Normalized values for deduplication</td>
</tr>
</table>

### 🎯 Use cases

- **Lead generation**: turn a list of company websites into a call/email list for your sales team
- **CRM enrichment**: fill in missing phone numbers, emails, and social links for existing accounts
- **Local business outreach**: combine with a Google Maps scraper to go from "dentists in Dublin" to a full outreach list
- **Website audits**: verify that a client's contact details are consistent across every page of their site
- **Market research**: map which social platforms companies in a niche actually maintain

### ⬇️ How to use

1. Click **Try for free** to open the actor in Apify Console.
2. Add one or more website URLs to **Start URLs** — homepages work well, since the crawler finds contact pages on its own.
3. Set **Maximum pages per start URL** (default 20) and **Maximum crawl depth** (default 1). Depth 1 with 10–20 pages covers most small business sites; single pages need depth 0.
4. Leave **Stay on the same domain** enabled unless you want the crawler to wander off-site.
5. Click **Start**. Each website's contacts appear in the dataset as soon as it is done.
6. Open the **Output** tab to preview results, or the **Storage → Dataset** tab to download them as JSON, CSV, Excel, or XML.

### ⚙️ Input parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `startUrls` | array | Yes | — | Public website URLs to crawl for contact details, one website or page per item |
| `maxPagesPerStartUrl` | integer | No | 20 | Maximum pages fetched per start URL (1–100). Lower is faster, higher finds more |
| `maxDepth` | integer | No | 1 | Link levels to follow (0–3). Depth 0 fetches only the given URL |
| `sameDomainOnly` | boolean | No | true | Follow only links on the same root domain as the start URL |
| `includeSocialProfiles` | boolean | No | true | Extract LinkedIn, Facebook, Instagram, X/Twitter, YouTube, TikTok, and WhatsApp links |
| `includeExternalLinks` | boolean | No | false | Also output contact-like links that point away from the source domain |
| `requestTimeoutSecs` | integer | No | 30 | Per-page request timeout in seconds (5–120) |

### ⬆️ Output example

Each contact detail is one dataset row, so the export opens cleanly in a spreadsheet. Real output from a run against a dental clinic's website:

```json
[
  {
    "sourceUrl": "https://seapointclinic.ie/",
    "pageUrl": "https://www.seapointclinic.ie/",
    "domain": "seapointclinic.ie",
    "contactType": "email",
    "contactValue": "info@seapointclinic.ie",
    "normalizedContactValue": "info@seapointclinic.ie",
    "context": "4-6 The Avenue, Beacon Court, Sandyford, D18 DE43 Contact Us 01 284 2570 info@seapointclinic.ie Opening Hours",
    "linkText": "",
    "pageTitle": "Seapoint Dental Clinic South Dublin | Dentist Blackrock",
    "depth": 0,
    "discoveredAt": "2026-07-10T20:34:12Z",
    "socialPlatform": ""
  },
  {
    "sourceUrl": "https://seapointclinic.ie/",
    "pageUrl": "https://www.seapointclinic.ie/",
    "domain": "seapointclinic.ie",
    "contactType": "phone",
    "contactValue": "01 284 2570",
    "normalizedContactValue": "012842570",
    "context": "Oral Surgery CT Scanning Facial Aesthetics FEES CONTACT US 01 284 2570 GET IN TOUCH BOOK ONLINE",
    "linkText": "",
    "pageTitle": "Seapoint Dental Clinic South Dublin | Dentist Blackrock",
    "depth": 0,
    "discoveredAt": "2026-07-10T20:34:12Z",
    "socialPlatform": ""
  }
]
```

`contactType` is one of `email`, `phone`, `mailto`, `tel`, `whatsapp`, `social_profile`, or `contact_page`. The `normalizedContactValue` field gives you a lowercase email or digits-only phone number for matching against your CRM, while `contactValue` keeps the original formatting. `context` shows the text around the match so you can judge relevance at a glance.

### 💰 How much does it cost to scrape contact details?

You pay per contact detail saved to the dataset. Websites that show no contact details cost nothing, and the list of start URLs that could not be opened is saved in the run's OUTPUT record so you can check them.

### ❓ FAQ

#### Can I extract emails from Google Maps businesses?

Yes, in two steps: run [Google Maps Scraper](https://apify.com/automly/google-maps-scraper) to find businesses by keyword and location, then feed the website URLs from its output into this actor's **Start URLs**. That takes you from "plumbers in Manchester" to a spreadsheet of emails, phones, and social profiles.

#### What export formats are supported?

Everything the Apify platform offers: **JSON, CSV, Excel, XML, and HTML**. Download from the dataset tab or fetch programmatically via the dataset API.

#### Can I integrate it with other apps?

Yes. Through Apify integrations it connects to Google Sheets, Zapier, Make, Slack, GitHub, LangChain, and more. Webhooks can notify your systems or trigger follow-up actions whenever a run finishes — for example, append new leads to a sheet every Monday morning.

#### Can I run it via API, MCP, or on a schedule?

Yes. Every Apify actor exposes a REST API — start runs, pass input, and read results from any language, or use the official JavaScript and Python clients (see the **API** tab for ready-made code). AI agents can call it through the Apify MCP server. The built-in scheduler handles recurring runs, such as a weekly refresh of your prospect list.

#### Why did a site return few or no contacts?

The most common reason is a site that renders its content entirely with JavaScript — this actor fetches server-delivered HTML, which is fast and cheap and works for the large majority of business websites, but a purely client-rendered page may show little text to extract. Also check that your `maxDepth` and `maxPagesPerStartUrl` are high enough to reach the contact page.

#### How do I scrape contact details from hundreds of websites at once?

Add all of them to **Start URLs** (you can paste a list). Keep `maxDepth` at 1 and `maxPagesPerStartUrl` around 10–20 to keep the run quick and cheap. Results carry a `domain` column, so grouping the export by company is a one-click pivot.

#### Does it handle duplicate contacts?

Yes. Results are deduplicated per root domain using the normalized value, so `Info@Example.com` on the homepage and `info@example.com` on the contact page produce a single row.

### 🔗 Related actors

- [Google Maps Scraper](https://apify.com/automly/google-maps-scraper) — find businesses by keyword and location, then feed their websites into this actor for full contact details
- [Facebook Ad Library Scraper](https://apify.com/automly/facebook-ad-library-scraper) — discover companies actively spending on ads, a strong buying signal for outreach
- [Google Ads Transparency Scraper](https://apify.com/automly/google-ads-transparency-scraper) — see which advertisers run Google ads in your niche
- [Shopify Products Scraper](https://apify.com/automly/shopify-products-scraper) — extract product catalogs from Shopify stores you have identified as prospects

# Actor input Schema

## `startUrls` (type: `array`):

Public website URLs to crawl for contact details. Add one website or page URL per item.

## `maxPagesPerStartUrl` (type: `integer`):

Maximum number of pages to fetch from each start URL. Lower values are faster; higher values discover more contacts.

## `maxDepth` (type: `integer`):

How many link levels to follow from each start URL. Depth 0 fetches only the given URL; depth 1 also follows links from it.

## `sameDomainOnly` (type: `boolean`):

When enabled, the crawler follows only links on the same root domain as the start URL.

## `includeSocialProfiles` (type: `boolean`):

Extract LinkedIn, Facebook, Instagram, X/Twitter, YouTube, TikTok, and WhatsApp profile or contact links.

## `includeExternalLinks` (type: `boolean`):

When enabled, output contact-like external links such as social profiles and contact pages even when they point away from the source domain.

## `requestTimeoutSecs` (type: `integer`):

Maximum time to wait for each page request before skipping it.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://apify.com/contact"
    }
  ],
  "maxPagesPerStartUrl": 20,
  "maxDepth": 1,
  "sameDomainOnly": true,
  "includeSocialProfiles": true,
  "includeExternalLinks": false,
  "requestTimeoutSecs": 30
}
```

# Actor output Schema

## `contacts` (type: `string`):

One row per contact detail: type, value, and where it was found.

## `fullData` (type: `string`):

All fields including context, link text, page title, and crawl depth.

# 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 = {
    "startUrls": [
        {
            "url": "https://apify.com/contact"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/contact-details-scraper").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 = { "startUrls": [{ "url": "https://apify.com/contact" }] }

# Run the Actor and wait for it to finish
run = client.actor("automly/contact-details-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://apify.com/contact"
    }
  ]
}' |
apify call automly/contact-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/contact-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HCLO1zWWo49MfVAZF/builds/P73LBBK6fMEP88Qcb/openapi.json
