# Contacts Details Scraper (`solid-scraper/contacts-details-scraper`) Actor ๐Ÿ“‡ Contacts Details Scraper extracts accurate contact info from websites fastโ€”ideal for sales, recruiting, and lead gen. ๐Ÿ”Ž Save time, boost outreach, and enrich your CRM automatically. ๐Ÿš€ Get targeted data in minutes! - **URL**: https://apify.com/solid-scraper/contacts-details-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (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 $2.99 / 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 ๐Ÿ” **Contacts Details Scraper** helps you extract **email addresses**, **phone numbers**, and **social media profile links** from websites so you can quickly build business contact lists for outreach, research, and CRM enrichment. Itโ€™s designed for scenarios where you need contact information scraper capabilities at scaleโ€”whether youโ€™re a marketer, recruiter, sales lead, or data analystโ€”and it saves you hours of manual digging across sites. In practice, this contacts details harvesting tool scrapes data from **publicly available sources** and outputs structured results per domain, ready for analysis, deduplication, and export. --- ### Why choose Contacts Details Scraper? | Feature | Benefit | | --- | --- | | โœ… **All-in-one extraction** (emails, phone numbers, social links) | Collect multiple contact types from the same set of websites in one run | | โœ… **Configurable output** | Turn phone extraction and social media extraction on/off to match your workflow | | โœ… **Built-in proxy support** | Improves success rates and reduces the chance of blocks during scraping | | โœ… **Resilient crawling limits** | Targets a controlled number of pages per domain (max pages per domain) | | โœ… **Structured dataset output** | Produces clean fields like `domain`, `emails`, `phone_numbers`, and `social_media` for easy importing | | โœ… **Scales to batches** | Process multiple domains in a single execution and push results continuously | --- ### Key features - ๐Ÿ“ง **Email extraction from websites:** Finds email addresses and returns them with source and confidence metadata - โ˜Ž๏ธ **Phone number extraction (optional):** Pulls phone numbers when enabled and includes formatting + source URL - ๐ŸŒ **Social media link extraction (optional):** Extracts social profile links and deduplicates by normalized URL - ๐Ÿ›ก๏ธ **Reliability with proxy support:** Uses your proxy configuration to improve consistency for bulk scraping - ๐Ÿ”„ **Execution across multiple domains:** Accepts a list of website URLs or domains and scrapes each one in turn - ๐Ÿ’พ **Dataset-first results:** Pushes each domainโ€™s result into the Apify dataset as it completes - ๐Ÿ“Š **Confidence-aware email records:** Includes `confidence_score`, `validation_status`, and extraction sources per email - ๐Ÿงพ **Clean, marketer-friendly structure:** Returns arrays for `emails`, `phone_numbers`, and `social_media` so you can map directly into lead lists and CRM fields --- ### Input Provide input via an `input.json` file. Example structure: ```json { "startUrls": [ { "url": "https://example.com" }, { "url": "example.org" } ], "extractPhoneNumbers": true, "extractSocialMedia": true, "proxyConfiguration": { "useApifyProxy": true } } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `startUrls` | โœ… Yes | A list of website URLs or domains to scrape. Each item should contain a `url` string (e.g., `https://example.com` or `example.com`). | | `extractPhoneNumbers` | โŒ No | Set to `true` to extract phone numbers from pages along with emails. Defaults to `true`. | | `extractSocialMedia` | โŒ No | Set to `true` to extract social media profile links (Facebook, Twitter, LinkedIn, Instagram, etc.). Defaults to `true`. | | `proxyConfiguration` | โŒ No | Proxy and browser configuration. Residential proxies are recommended for better success rates. Includes `proxy support` and other proxy editor options. Prefilled with `proxy support: true`. | ##### `proxyConfiguration` nested fields | Field | Required | Description | | --- | --- | --- | | `proxyConfiguration.proxy support` | โŒ No | If enabled, the actor uses Apify Proxy settings for better reliability during scraping. Prefilled as `true`. | *** ### Output After execution, the actor pushes each domainโ€™s scraped result into the Apify dataset in JSON format. #### Example output (one dataset row) ```json { "domain": "example.com", "homepage_url": "https://example.com", "emails": [ { "email": "contact@example.com", "confidence_score": 72.5, "source_url": "https://example.com/contact", "source_type": "contact_page", "validation_status": "unknown" } ], "phone_numbers": [ { "phone": "+1 555 123 4567", "formatted": "+15551234567", "source_url": "https://example.com/contact" } ], "social_media": [ { "platform": "linkedin", "url": "https://www.linkedin.com/company/example", "source_url": "https://example.com" } ] } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `domain` | string | The domain derived from your input `startUrls`. | | `homepage_url` | string | A homepage link built as `https://{domain}`. | | `emails` | array | List of extracted email entries (empty when none are found or if an error occurs). | | `phone_numbers` | array | List of extracted phone entries (empty when none are found or if disabled). | | `social_media` | array | List of extracted social profile links (deduplicated by normalized URL). | ##### `emails` array fields | Field | Type | Description | | --- | --- | --- | | `email` | string | The extracted email address. | | `confidence_score` | number | Confidence score for the extraction. | | `source_url` | string | The page where the email was found. | | `source_type` | string | The type of page/section the email came from (e.g., `contact_page`, `footer`, etc.). | | `validation_status` | string | Validation status string for the email record. | ##### `phone_numbers` array fields | Field | Type | Description | | --- | --- | --- | | `phone` | string | Extracted phone number. | | `formatted` | string | Formatted phone value (when available). | | `source_url` | string | The page where the phone was found. | ##### `social_media` array fields | Field | Type | Description | | --- | --- | --- | | `platform` | string | Social platform name (e.g., Facebook, Twitter, LinkedIn, Instagram, etc.). | | `url` | string | The discovered social profile URL. | | `source_url` | string | The page where the social link was found. | > Export tip: After downloading the dataset, you can move results into spreadsheets or CSV workflows for CRM contact data extraction. *** ### How to use Contacts Details Scraper (via Apify Console) 1. **Open Apify Console**\ Go to [console.apify.com](https://console.apify.com) and sign in. 2. **Find the actor**\ Search for **Contacts Details Scraper** in the Actors marketplace. 3. **Add your input**\ In the **INPUT** panel, paste the JSON structure required by the actor. The most important field is `startUrls` (website URLs or domains). 4. **Choose extraction options**\ Decide whether you want `extractPhoneNumbers` and `extractSocialMedia` set to `true` or `false`. 5. **Configure proxy (recommended for reliability)**\ Use the built-in **proxy** configuration. Residential proxies are recommended for better success rates, and `proxy support` is prefilled in the UI. 6. **Run the actor**\ Click **Run**. During execution youโ€™ll see domain-by-domain progress in the logs, and results are pushed to the dataset as each domain completes. 7. **Review and export results**\ Open the **OUTPUT** tab, locate the dataset, and export your scraped contacts details in the format you need (JSON or CSV-style workflows after export). No coding requiredโ€”get structured contact data extraction tool results in minutes. *** ### Advanced features & SEO optimization - ๐Ÿ“Œ **Engineered for contacts details scraping:** Built specifically to extract **emails, phone numbers, and social media links** from websitesโ€”useful for a web contact scraper workflow - ๐Ÿ”Ž **Domain input flexibility:** Accepts both full URLs (like `https://example.com`) and plain domains (like `example.com`) - ๐Ÿ” **Resilience for bulk scraping:** Includes retries and fallbacks for resilience when dealing with real-world site behavior - ๐Ÿง  **Confidence-aware email records:** Each email includes `confidence_score`, `validation_status`, and extraction source metadata - ๐Ÿ“ **Reliable structured output:** Arrays for `emails`, `phone_numbers`, and `social_media` make CRM contact scraper imports straightforward *** ### Best use cases - ๐Ÿ“ˆ **Sales teams building B2B lead scraping tool lists:** Gather emails and phone numbers from target company websites for outreach sequences - ๐Ÿง‘โ€๐Ÿ’ผ **Recruiters sourcing hiring contacts:** Extract contact details harvesting results from company โ€œcontactโ€ and โ€œteamโ€ style pages - ๐Ÿงช **Market researchers mapping business presence:** Collect business contacts scraper data across multiple domains and analyze by email availability and social presence - โœ‰๏ธ **Email outreach operations:** Use bulk contact email scraper outputs to populate outreach tooling with verified fields and source references - ๐Ÿ—‚๏ธ **Analysts creating contact datasets:** Combine contact information scraper results into structured tables for reporting and enrichment - ๐Ÿ”— **CRM admins running enrichment pipelines:** Feed contacts details scraper output directly into CRM contact fields (emails, phone numbers, social links) - ๐Ÿ“š **Directory and web research projects:** Use the actor as a contact data extraction tool for building directory contacts scraper style datasets *** ### Technical specifications - **Supported Input Formats** - โœ… `startUrls`: list of website URLs or domains, where each entry contains a `url` string - **Proxy Support** - โœ… Proxy configuration via `proxyConfiguration` (includes `proxy support`) - **Retry Mechanism** - โœ… Includes retries and fallbacks for resilience - **Dataset Structure** - โœ… One dataset row per scraped `domain`, containing `domain`, `homepage_url`, `emails`, `phone_numbers`, `social_media` - **Rate Limits & Performance** - โœ… Controlled crawling limits per domain (max pages per domain) - **Limitations** - โŒ Only data found on **publicly accessible** website pages can be extracted - โŒ If no valid domains are derived from `startUrls`, the actor logs a warning and exits without scraping *** ### FAQ #### What data does Contacts Details Scraper extract? โœ… Contacts Details Scraper extracts **emails**, **phone numbers** (when `extractPhoneNumbers` is enabled), and **social media links** (when `extractSocialMedia` is enabled) from publicly available website content. The results are pushed into the dataset per `domain`. #### Can I scrape both phone numbers and social media links? โœ… Yes. By default, both `extractPhoneNumbers` and `extractSocialMedia` are set to `true`, but you can disable either one to tailor the output. #### What input format should I use for startUrls? โœ… You can provide `startUrls` as an array where each item contains a `url` string, and the actor accepts both full URLs (example: `https://example.com`) and plain domains (example: `example.org`). #### How is the output structured in the dataset? โœ… Each dataset entry includes `domain` and `homepage_url`, plus arrays for `emails`, `phone_numbers`, and `social_media`. Social links are deduplicated by normalized URL in the result. #### Does the actor support proxies? โœ… Yes. You can configure `proxyConfiguration`, and it supports `proxy support` through the Apify Console proxy editor. This helps improve scraping reliability for a contacts details harvesting workflow. #### Is this tool suitable for lead generation and CRM enrichment? โœ… Yes. The structured output is designed to plug into lead contacts scraper and CRM contact scraper workflows, since it includes both the extracted contact data and source metadata like `source_url` and `source_type` for emails. #### Are emails validated before being returned? โœ… The dataset includes `validation_status` and `confidence_score` for each email record, but the actorโ€™s fixed configuration sets `validate_emails` to `False`. The output still includes validation-related fields exactly as provided by the scraping job results. #### Is it compliant to use this actor for collecting contact information? โœ… Use the actor responsibly: it collects information from **publicly accessible sources**, and you are responsible for complying with applicable laws (including GDPR/CCPA where relevant), spam regulations, and the target sitesโ€™ terms of service. *** ### Support & feature requests Want to improve Contacts Details Scraper for your contacts details scraping workflow? Weโ€™d love to hear from you. - ๐Ÿ’ก **Feature Requests:** For example, enhancements like CSV exports, additional field mapping, or custom extraction controls for contact data extraction tool use cases. - ๐Ÿ“ง **Contact:** Email us at . Your feedback helps shape the roadmap for future versions of this contacts details harvesting tool. *** ### Closing CTA / Final thoughts *Contacts Details Scraper is an SEO-optimized, structured contacts details scraper built for real-world lead and research workflows.*\ *If you need contact information scraper results fast and at scale, this is a solid choice.* *** ### Disclaimer **This actor accesses only publicly accessible sources** and extracts contact information from publicly available web content. It does not access private profiles, authenticated pages, or password-protected data. You are responsible for ensuring your use complies with applicable laws (including GDPR and CCPA where relevant), spam regulations, and the terms of service of the websites you scrape. For data-removal requests, contact: . Please use this tool responsibly, ethically, and for legitimate purposes only. # 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("solid-scraper/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("solid-scraper/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 solid-scraper/contacts-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/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 websites fastโ€”ideal for sales, recruiting, and lead gen. ๐Ÿ”Ž Save time, boost outreach, and enrich your CRM automatically. ๐Ÿš€ Get targeted data in minutes!", "version": "1.0", "x-build-id": "LUKqJjzmPiZRIbjNb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~contacts-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-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/solid-scraper~contacts-details-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-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/solid-scraper~contacts-details-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-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 } } } } } } } } } } ```