# Contacts Details Scraper (`scraperoka/contacts-details-scraper`) Actor 📇 Contacts Details Scraper extracts accurate contact info from targeted sources. ✨ Capture names, emails, phone numbers & more to power B2B lead gen, outreach & CRM enrichment. ⚡ Fast, reliable, and built for smarter sales pipelines. - **URL**: https://apify.com/scraperoka/contacts-details-scraper.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results 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 ### Contacts Details Scraper 🚀 Manually visiting websites to collect emails and phone numbers wastes hours you don’t have. **Contacts Details Scraper** automatically extracts contact details you can use for outreach—perfect for marketers, recruiters, and growth teams. It’s a practical contacts details scraper and contact scraper tool for building business contacts scraper lists fast, often reaching thousands of records in a single run. --- ### What You Get: Sample Output Here's a sample record from a single run: ```json { "domain": "example.com", "homepage_url": "https://example.com", "emails": [ { "email": "contact@example.com", "confidence_score": 92.4, "source_url": "https://example.com/contact", "source_type": "contact_page", "validation_status": "unknown" }, { "email": "support@example.com", "confidence_score": 83.1, "source_url": "https://example.com/support", "source_type": "body", "validation_status": "unknown" } ], "phone_numbers": [ { "phone": "+1 555 010 2020", "formatted": "+15550102020", "source_url": "https://example.com/contact" } ], "social_media": [ { "platform": "linkedin", "url": "https://www.linkedin.com/company/example", "source_url": "https://example.com/about" }, { "platform": "twitter", "url": "https://twitter.com/example", "source_url": "https://example.com" } ] } ```` | Field | Type | What It Tells You | |---|---|---| | `domain` | string | The target domain used to scrape contact information for your lead list | | `homepage_url` | string | A direct “home” link for reference and quick QA | | `emails` | array | All extracted email addresses detected on the site | | `emails[].email` | string | The actual email address you can use for outreach | | `emails[].confidence_score` | number | A signal for how strongly the actor believes the email is relevant | | `emails[].source_url` | string | Where the email was found on the website (helps with verification) | | `emails[].source_type` | string | The page context (for example, contact page vs body) | | `emails[].validation_status` | string | Email validation outcome status as returned by the actor | | `phone_numbers` | array | Extracted phone numbers (when enabled) | | `phone_numbers[].phone` | string | The raw phone value found on the site | | `phone_numbers[].formatted` | string or null | A formatted phone value when available | | `phone_numbers[].source_url` | string | Where the phone number was found | | `social_media` | array | Social profile links (deduplicated) found on the site | | `social_media[].platform` | string | The social platform label for filtering and CRM mapping | | `social_media[].url` | string | The profile link you can store directly | | `social_media[].source_url` | string | The page where the link was discovered | | `status` / `error_message` | not included in output | If an error occurs for a domain, the actor returns empty arrays for `emails`, `phone_numbers`, and `social_media` (no dataset error fields in the record) | Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard. *** ### Why Contacts Details Scraper? There are a lot of ways to pull data from websites—here’s what sets Contacts Details Scraper apart. #### Website contact extraction in one run Contacts Details Scraper is designed specifically to extract emails and phone numbers (when enabled), plus social media links, from the websites you provide. It focuses on producing lead generation contact scraper-ready output rather than messy, unstructured text. #### Output is structured for real workflows The actor stores results in a consistent dataset schema with `domain`, `homepage_url`, `emails`, `phone_numbers`, and `social_media`. That makes it easy to plug the results into CRM contact data scraper pipelines and automate contact list building tool steps. #### Built for resilience across multiple domains If scraping a domain fails, the actor still pushes a record with empty arrays for `emails`, `phone_numbers`, and `social_media`. This makes downstream processing more reliable when building business contacts scraper datasets. #### Deduplicated social links for cleaner lead lists When social media links are extracted, duplicates are removed in the output based on the normalized canonical link. This improves the usefulness of a web contact details scraper for outreach teams who need clean profile URLs. *** ### Configuring Your Run Drop this into your `input.json` to get started: ```json { "startUrls": [ { "url": "https://example.com" }, { "url": "example.org" } ], "extractPhoneNumbers": true, "extractSocialMedia": true, "proxyConfiguration": { "useApifyProxy": true } } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrls` | ✅ | List of website URLs or domains to scrape for contacts details extraction | | `extractPhoneNumbers` | ⬜ | Controls whether the actor extracts phone numbers from pages along with emails | | `extractSocialMedia` | ⬜ | Controls whether the actor extracts social media profile links (Facebook, Twitter, LinkedIn, Instagram, etc.) | | `proxyConfiguration` | ⬜ | Proxy settings to improve reliability while scraping websites | | ↳ `proxy support` | ⬜ | When set to `true`, the actor uses Apify Proxy for the run | *** ### Core Capabilities #### Scrapes emails, phone numbers, and social links Contacts Details Scraper extracts email addresses and can also extract phone numbers (when `extractPhoneNumbers` is enabled). With `extractSocialMedia` enabled, it pulls social profile links too—useful for a CRM contact data scraper or a contact list building tool. #### Input flexibility: URLs or domains You can provide `startUrls` as full website URLs (including `https://...`) or as domains without protocol. The actor parses them and generates a `homepage_url` in the output for each `domain`. #### Reliable dataset writing per domain Results are pushed to the dataset as the run processes each domain. This keeps a steady flow of structured data as you scale up to B2B contact scraper workflows. #### Output includes sources for easier verification For each email and phone number, the dataset includes `source_url` (and `source_type` for emails). That source context is valuable when you’re doing contact information extractor QA before import. #### Built-in resilience for multi-domain runs The actor includes error handling so that even if one domain fails, you still get a pushed record (with empty contact arrays) and can continue the rest of your batch. *** ### Who Gets the Most Out of This Here’s how different teams put Contacts Details Scraper to work: **Growth teams building lead lists** — Provide a list of target domains, and get a structured dataset with emails, phone\_numbers (if enabled), and social\_media links. This speeds up contact list building tool workflows and reduces manual research time. **Sales development representatives (SDRs)** — Turn a directory of business websites into outreach-ready leads, including emails and verified source context via `source_url`. It’s a fast lead generation contact scraper approach for prospecting at scale. **Recruiters sourcing talent** — When companies publish contact information on their websites, this contacts details scraper helps compile multiple ways to reach the organization. Add social links when `extractSocialMedia` is enabled to enrich your CRM contact data. **Data analysts and researchers** — Use the consistent fields (`domain`, `emails`, `phone_numbers`, `social_media`) to study contact availability patterns across industries or geographies. For data scraping contacts projects, the structured output makes analysis and auditing straightforward. **Automation specialists (developers and integrators)** — Integrate the Contacts Details Scraper output into downstream systems via Apify dataset export or API-driven automation. The JSON structure is ready for transformation steps in your pipeline for a contact data extraction software workflow. *** ### Step-by-Step: How to Use It No coding needed. Here's how to run Contacts Details Scraper from start to finish: 1. **Open the actor on Apify** — go to [console.apify.com](https://console.apify.com) and find Contacts Details Scraper. 2. **Enter your inputs** — add your targets in `startUrls`, and choose whether you want `extractPhoneNumbers` and `extractSocialMedia`. 3. **Configure proxy settings (optional but recommended)** — set `proxyConfiguration.proxy support` to `true` for better reliability. 4. **Hit Run and watch the live log** — monitor the run as it processes each `domain`. 5. **View results in the dataset tab** — your dataset fills with records containing `emails`, `phone_numbers`, and `social_media`. 6. **Export as JSON, CSV, or Excel** — download directly from the Apify dashboard when you’re ready to use the data. The whole process takes under 5 minutes to set up. *** ### Integrations & Export Options Once your data is collected, Contacts Details Scraper plugs directly into your existing workflow. You can export your dataset from the Apify dataset tab in common formats like JSON, CSV, or Excel. This makes it easy to use as-is for business contacts scraper projects or transform it for your CRM. You can also connect the actor to automation and systems via Apify API-driven workflows (see [Apify API docs](https://apify.com/docs/api)) and trigger downstream actions with webhooks when runs complete. No-code automation tools like Zapier or Make can use the exported dataset output to push results anywhere you need. *** ### Pricing & Free Trial Contacts Details Scraper runs on the Apify platform, which offers a **free tier** — no credit card required to get started. The free tier typically includes $5 platform credits on sign-up, enough for several test runs. After that, usage is generally pay-as-you-go based on Apify platform compute units (CU), without requiring a monthly fee. Start for free at [apify.com](https://apify.com) and scale when you’re ready. *** ### Reliability & Performance | What We Handle | How | |---|---| | Multi-domain batches | Processes each provided `domain` and pushes results to the dataset | | Resilience when a domain fails | Pushes a result record with empty `emails`, `phone_numbers`, and `social_media` for that domain | | Proxy support | Supports proxy configuration to improve scraping reliability | | Configurable extraction | You choose whether to extract `extractPhoneNumbers` and `extractSocialMedia` | | Structured output | Dataset records follow a consistent schema for straightforward downstream use | Limitations: The actor scrapes contact details from publicly available website content. If a site doesn’t publish emails/phones/social links, the corresponding arrays may be empty in the output. For enterprise-scale runs, contact us to discuss custom configurations. *** ### Frequently Asked Questions #### Is there a free plan or trial? Yes—Apify provides a free tier to help you test actors before you scale. You can run smaller scraping jobs and export the dataset to evaluate data quality for your use case. #### Do I need to log in to use this? No. Contacts Details Scraper is designed to extract contact details from publicly available data published on websites, so you don’t need website logins to run it. #### How accurate is the data? It depends on what the websites publish. Contacts Details Scraper extracts emails, phone numbers (if enabled), and social links from the website content it encounters and includes `source_url` (and `source_type` for emails) to help you verify results. #### How many results can I get per run? You’ll get one dataset record per input domain in `startUrls`. Emails, phone numbers, and social links are returned as arrays inside each record, and the number of items depends on how much contact information the site provides. #### How often is the data updated / how fresh is it? The data is fresh at the time of the run. If you need updated contact information, re-run the actor for the domains you care about and compare the latest dataset export. #### Is this legal? Does it comply with GDPR / CCPA? In general, Contacts Details Scraper works with **publicly available data** on websites, but legality and compliance depend on how you store, process, and use the data in your own business context. Make sure you follow GDPR, CCPA, and relevant platform policies before importing contacts into your systems. #### Can I export results to Google Sheets or Excel? Yes. You can export from the Apify dashboard; the actor writes results to your Apify dataset, which you can download in common formats. From there, you can import into tools like Excel or a sheet workflow. #### Can I run this on a schedule automatically? Yes. You can schedule actor runs on Apify so your contacts datasets refresh automatically on a cadence you choose. Refer to Apify scheduling options in the platform documentation for details. #### Can I access this via API? Yes. You can programmatically trigger and fetch results using the Apify API. See [Apify API docs](https://apify.com/docs/api) for the latest guidance. #### What happens if the actor hits an error? If an error occurs while scraping a specific domain, Contacts Details Scraper still pushes a dataset record for that domain with empty `emails`, `phone_numbers`, and `social_media` arrays. This helps keep multi-domain runs consistent so your pipeline can continue processing. *** ### Need Help or Have a Request? Got a question about Contacts Details Scraper or want a new feature added? Reach out at . We’re actively maintaining the actor and regularly improve it based on real user feedback. If you have ideas like webhook notifications on completion or additional export-friendly fields, tell us what you need. *** ### Disclaimer & Responsible Use *Contacts Details Scraper is the fastest, most reliable way to extract contacts details from publicly available website content — start your free run today.*\ This actor collects **publicly available data** from websites. It does not access private accounts, login-gated content, or password-protected pages. You’re responsible for GDPR/CCPA compliance and for using the extracted data in accordance with applicable laws and site Terms of Service. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `startUrls` (type: `array`): List of website URLs or domains to scrape (e.g., https://example.com or example.com). ## `extractPhoneNumbers` (type: `boolean`): Extract phone numbers from pages along with emails. ## `extractSocialMedia` (type: `boolean`): Extract social media profile links (Facebook, Twitter, LinkedIn, Instagram, etc.). ## `proxyConfiguration` (type: `object`): Select proxy settings. Residential proxies recommended for better success rates. ## Actor input object example ```json { "startUrls": [ { "url": "https://apify.com" } ], "extractPhoneNumbers": true, "extractSocialMedia": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "startUrls": [ { "url": "https://apify.com" } ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("scraperoka/contacts-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://apify.com" }], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("scraperoka/contacts-details-scraper").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 '{ "startUrls": [ { "url": "https://apify.com" } ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call scraperoka/contacts-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/contacts-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Contacts Details Scraper", "description": "📇 Contacts Details Scraper extracts accurate contact info from targeted sources. ✨ Capture names, emails, phone numbers & more to power B2B lead gen, outreach & CRM enrichment. ⚡ Fast, reliable, and built for smarter sales pipelines.", "version": "1.0", "x-build-id": "kZyM8LSfX71HPldM1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~contacts-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-contacts-details-scraper", "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/scraperoka~contacts-details-scraper/runs": { "post": { "operationId": "runs-sync-scraperoka-contacts-details-scraper", "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/scraperoka~contacts-details-scraper/run-sync": { "post": { "operationId": "run-sync-scraperoka-contacts-details-scraper", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Website URLs or Domains", "type": "array", "description": "List of website URLs or domains to scrape (e.g., https://example.com or example.com).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "extractPhoneNumbers": { "title": "Extract Phone Numbers", "type": "boolean", "description": "Extract phone numbers from pages along with emails.", "default": true }, "extractSocialMedia": { "title": "Extract Social Media Links", "type": "boolean", "description": "Extract social media profile links (Facebook, Twitter, LinkedIn, Instagram, etc.).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select proxy settings. Residential proxies recommended for better success rates." } } }, "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 } } } } } } } } } } ```