# Company Domain and Social Links Finder (`automation-lab/company-domain-social-links-finder`) Actor Find likely official company domains and public homepage social links for CRM enrichment, lead research, and account data cleanup. - **URL**: https://apify.com/automation-lab/company-domain-social-links-finder.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Company Domain and Social Links Finder Turn a list of company names into likely official domains and public social profiles. This Apify Actor helps lead enrichment, CRM cleanup, account research, and partner discovery workflows where you have a company name but need a trustworthy website URL plus homepage-declared social links. ### What does Company Domain and Social Links Finder do? Company Domain and Social Links Finder searches the public web for each company name, scores likely official domains, fetches the selected homepage, and extracts public social/profile links from footer anchors and JSON-LD `sameAs` data. It returns one dataset row per input company. Each row includes: - ๐Ÿข Input company name and optional country hint - ๐ŸŒ Likely official domain and website URL - ๐Ÿ“Š Confidence score and match method - ๐Ÿ”Ž Search result title and snippet used for matching - ๐Ÿงญ Alternative candidate domains - ๐Ÿ”— Homepage social links grouped by network - ๐Ÿงพ JSON-LD `sameAs` links when available - โš ๏ธ Per-company error messages instead of failing the whole run ### Who is it for? This actor is useful for teams that need domain and profile enrichment without building their own search and homepage parsing pipeline. Typical users include: - Sales operations teams cleaning lead lists - RevOps teams enriching CRM accounts - Data providers building company datasets - Recruiters researching employer profiles - Growth marketers preparing account-based marketing lists - Analysts matching company names to web presence - Developers adding domain enrichment to automations ### Why use it? Company names are often messy. A CRM may contain `Stripe`, `Stripe Inc`, `Stripe USA`, or `Stripe Payments` while downstream tools need `stripe.com`. This actor combines search-result evidence with homepage extraction so you can quickly move from a raw company name to usable web identifiers. ### How it works For each company, the actor: 1. Normalizes the company name and optional hints. 2. Uses DuckDuckGo HTML search for public candidate pages. 3. Filters directory, social, search, and marketplace domains. 4. Scores official-domain candidates by company-token matches, title, snippet, and country hints. 5. Fetches the winning homepage. 6. Extracts social links from anchors and JSON-LD `sameAs` data. 7. Saves a typed dataset row and continues with the next company. ### Input Use the `companies` input field. You can provide plain strings: ```json { "companies": ["OpenAI", "Stripe", "Apify"] } ```` You can also provide structured objects: ```json { "companies": [ { "name": "Stripe", "country": "United States" }, { "name": "Apify", "knownWebsite": "https://apify.com" } ], "includeSocialLinks": true, "maxCandidates": 5, "requestDelayMs": 600 } ``` ### Input fields | Field | Type | Description | | --- | --- | --- | | `companies` | array | Required list of company names or objects. | | `companies[].name` | string | Company name to resolve. | | `companies[].country` | string | Optional country hint for disambiguation. | | `companies[].knownWebsite` | string | Optional website to validate and enrich directly. | | `maxCandidates` | integer | Number of alternative domains to keep from search results. | | `includeSocialLinks` | boolean | Whether to fetch homepages and collect social links. | | `requestDelayMs` | integer | Delay between company lookups for conservative rate limiting. | ### Output data The actor stores results in the default dataset. | Field | Description | | --- | --- | | `companyName` | Original company name. | | `country` | Optional country hint. | | `inputWebsite` | Optional website supplied by the user. | | `domain` | Likely official domain. | | `websiteUrl` | URL used for homepage extraction. | | `confidence` | 0-100 score based on matching evidence. | | `matchMethod` | `duckduckgo_search`, `known_website`, or `none`. | | `matchedTitle` | Search title for the selected candidate. | | `matchedSnippet` | Search snippet for the selected candidate. | | `sourceSearchUrl` | DuckDuckGo search URL for auditability. | | `alternativeDomains` | Other candidate domains found. | | `socialLinks` | Grouped LinkedIn, X, Facebook, Instagram, YouTube, GitHub, TikTok, Crunchbase, and other links. | | `sameAsLinks` | JSON-LD `sameAs` links found on the homepage. | | `homepageTitle` | Title from the selected homepage. | | `error` | Per-company error if no candidate or fetch failed. | | `scrapedAt` | ISO timestamp. | ### Example output ```json { "companyName": "Apify", "domain": "apify.com", "websiteUrl": "https://apify.com/", "confidence": 95, "matchMethod": "known_website", "alternativeDomains": [], "socialLinks": { "linkedin": ["https://www.linkedin.com/company/apifytech/"], "github": ["https://github.com/apify"] }, "sameAsLinks": [], "homepageTitle": "Apify: Full-stack web scraping and browser automation platform", "scrapedAt": "2026-06-25T00:00:00.000Z" } ``` ### How much does it cost to find company domains and social links? This actor uses pay-per-event pricing. There is a small start fee per run and a per-company result fee. You can keep costs low by: - Running a small sample first - Providing `knownWebsite` when you already have a candidate domain - Turning off `includeSocialLinks` when you only need domain matching - Keeping `requestDelayMs` conservative for large batches ### Accuracy tips For best results: - Add country hints for common company names. - Use legal or brand names instead of abbreviations. - Review low-confidence matches before automated imports. - Use `alternativeDomains` when deciding between subsidiaries or regional sites. - Provide `knownWebsite` for existing CRM domains you want to enrich with socials. ### Common workflows #### CRM account enrichment Upload company names from your CRM and export the dataset as CSV. Map `domain`, `websiteUrl`, and `socialLinks.linkedin` back into your account records. #### Lead list cleanup Resolve raw company names from spreadsheets before running email discovery, ad audience matching, or company research tools. #### Partner research Find official websites and public social pages for potential partners, vendors, or sponsors. #### Data QA Compare `domain` and `alternativeDomains` against existing company-domain mappings to catch stale or wrong records. ### Integrations Use the output with: - CRMs such as HubSpot, Salesforce, or Pipedrive - Spreadsheet pipelines in Google Sheets or Airtable - Clay, Make, Zapier, and n8n workflows - Internal enrichment APIs - Data warehouses and lead scoring jobs ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/company-domain-social-links-finder').call({ companies: ['OpenAI', 'Stripe', 'Apify'], includeSocialLinks: true }); console.log(run.defaultDatasetId); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/company-domain-social-links-finder').call(run_input={ 'companies': ['OpenAI', 'Stripe', 'Apify'], 'includeSocialLinks': True, }) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~company-domain-social-links-finder/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"companies":["OpenAI","Stripe","Apify"],"includeSocialLinks":true}' ``` ### MCP usage Use this actor from Claude Desktop or Claude Code through Apify MCP. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/company-domain-social-links-finder ``` Claude Code setup: ```bash claude mcp add apify-company-domain-finder https://mcp.apify.com/?tools=automation-lab/company-domain-social-links-finder ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-company-domain-finder": { "url": "https://mcp.apify.com/?tools=automation-lab/company-domain-social-links-finder" } } } ``` Example prompts: - "Find official domains and LinkedIn pages for these 25 account names." - "Enrich this vendor list with company websites and social links." - "Check which companies in this CSV have low-confidence domain matches." ### Rate limits and reliability The actor uses public DuckDuckGo HTML search and public company homepages. For large batches, keep a delay between company lookups. If a run returns low-confidence matches, rerun with country hints or known websites. ### Legality and ethical use This actor collects publicly available search result snippets and links exposed on public company homepages. It does not log into websites, bypass private areas, or scrape private social-profile content. Make sure your use of exported data complies with applicable laws, platform terms, and your internal data policies. ### FAQ and troubleshooting #### Why did a company return no domain? The company name may be too generic, newly launched, local-only, or absent from indexed search results. Add a country hint or provide a known website. #### Why is the confidence score low? The domain did not strongly match the company tokens or the search title/snippet. Review alternatives before importing automatically. #### Why are social links missing? Some companies do not expose social profiles in homepage HTML or JSON-LD. The actor does not scrape social platforms directly. ### Related scrapers and tools Other automation-lab actors that pair well with this workflow: - Website Contact Finder - Domain Availability Checker - Google Search Scraper - LinkedIn Company tools when public profile extraction is needed ### Changelog Initial private build resolves company names to official domains and extracts homepage social links. ### Support If you need additional fields, submit an issue from the Apify Actor page with a sample input and expected output. # Actor input Schema ## `companies` (type: `array`): Company names to resolve. Use plain strings or objects with name, country, and knownWebsite. ## `maxCandidates` (type: `integer`): Maximum search-result domain candidates to score and expose as alternatives. ## `includeSocialLinks` (type: `boolean`): Fetch the selected homepage and collect public sameAs/footer links such as LinkedIn, X, Facebook, Instagram, YouTube, GitHub, TikTok, and Crunchbase. ## `requestDelayMs` (type: `integer`): Conservative delay between company lookups. Increase for large batches if DuckDuckGo starts rate-limiting. ## Actor input object example ```json { "companies": [ "OpenAI", { "name": "Stripe", "country": "United States" }, { "name": "Apify", "knownWebsite": "https://apify.com" } ], "maxCandidates": 5, "includeSocialLinks": true, "requestDelayMs": 20 } ``` # Actor output Schema ## `overview` (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 = { "companies": [ "OpenAI", { "name": "Stripe", "country": "United States" }, { "name": "Apify", "knownWebsite": "https://apify.com" } ], "maxCandidates": 5, "includeSocialLinks": true, "requestDelayMs": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/company-domain-social-links-finder").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 = { "companies": [ "OpenAI", { "name": "Stripe", "country": "United States", }, { "name": "Apify", "knownWebsite": "https://apify.com", }, ], "maxCandidates": 5, "includeSocialLinks": True, "requestDelayMs": 20, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/company-domain-social-links-finder").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 '{ "companies": [ "OpenAI", { "name": "Stripe", "country": "United States" }, { "name": "Apify", "knownWebsite": "https://apify.com" } ], "maxCandidates": 5, "includeSocialLinks": true, "requestDelayMs": 20 }' | apify call automation-lab/company-domain-social-links-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/company-domain-social-links-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Company Domain and Social Links Finder", "description": "Find likely official company domains and public homepage social links for CRM enrichment, lead research, and account data cleanup.", "version": "0.1", "x-build-id": "BujerLK7Yxgv5ijqG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~company-domain-social-links-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-company-domain-social-links-finder", "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/automation-lab~company-domain-social-links-finder/runs": { "post": { "operationId": "runs-sync-automation-lab-company-domain-social-links-finder", "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/automation-lab~company-domain-social-links-finder/run-sync": { "post": { "operationId": "run-sync-automation-lab-company-domain-social-links-finder", "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": [ "companies" ], "properties": { "companies": { "title": "Company names", "type": "array", "description": "Company names to resolve. Use plain strings or objects with name, country, and knownWebsite." }, "maxCandidates": { "title": "Alternative candidates per company", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum search-result domain candidates to score and expose as alternatives.", "default": 5 }, "includeSocialLinks": { "title": "Extract homepage social links", "type": "boolean", "description": "Fetch the selected homepage and collect public sameAs/footer links such as LinkedIn, X, Facebook, Instagram, YouTube, GitHub, TikTok, and Crunchbase.", "default": true }, "requestDelayMs": { "title": "Delay between companies (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Conservative delay between company lookups. Increase for large batches if DuckDuckGo starts rate-limiting.", "default": 600 } } }, "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 } } } } } } } } } } ```