# Company Social Presence Mapper - URLs + Followers for Clay (`mambalabs/company-social-presence-mapper`) Actor Resolves a company domain to its official LinkedIn, X, Instagram, Facebook, and YouTube URLs, plus follower counts where publicly accessible. Flat Clay-ready output with discovery method, per-platform status, and confidence scoring. - **URL**: https://apify.com/mambalabs/company-social-presence-mapper.md - **Developed by:** [Mamba Labs](https://apify.com/mambalabs) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $12.80 / 1,000 results 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 Social Presence Mapper Resolve a company domain to its official social media presence: LinkedIn, X, Instagram, Facebook, and YouTube URLs, plus follower and subscriber counts where they are publicly accessible. Flat, Clay-ready, pay-per-event. No login, no API keys, no personal data. Built for Clay users, RevOps teams, and outbound agencies that need a company's full social footprint in one row without stitching together five different scrapers. It extends the discovery pattern from the [Domain to LinkedIn URL Resolver](https://apify.com/mambalabs/domain-to-linkedin-url-resolver) (Actor ID 3HtnSaqPHOg1Qg5gx). ### What it does Give it a domain (and optionally a company name). For each of the five platforms it: 1. Discovers the official profile URL, preferring the links the company declares on its own homepage (schema.org `sameAs` and footer links), then a Brave search fallback, then a pattern guess as a last resort. 2. Validates the discovered URL against the company so an impersonator or fan page is not returned. 3. Fetches the public profile page and extracts the follower or subscriber count, where the platform exposes it without login. Output is one flat row per company, ready to drop into a Clay table or any CRM. ### How it works **Discovery cascade (most reliable first).** The company's own homepage is the best source: it links its real profiles, so those need no further validation. Anything the homepage does not declare is filled by a single Brave SERP scoped to the missing platforms, then by an obvious-handle guess that the follower fetch confirms. Each URL carries a `discovery` value (`homepage_sameas`, `homepage_link`, `search`, or `pattern_guess`) so you can see how it was found. **Follower extraction (HTTP only, no browser).** Each discovered profile page is fetched with got-scraping over the Apify Proxy, with retry and IP rotation. Counts are parsed from the page's embedded JSON or meta tags. YouTube uses a datacenter IP (its channel page is server-rendered); LinkedIn, Instagram, and Facebook use a residential IP. ### Input | Field | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `company_domain` | string | one of domain or name | stripe.com | Bare domain, e.g. stripe.com. | | `company_name` | string | one of domain or name | Stripe | Improves search accuracy and disambiguation. | | `platforms` | array | no | all five | Subset of `linkedin`, `x`, `instagram`, `facebook`, `youtube`. | | `includeFollowerCounts` | string | no | "true" | "true" fetches profile pages for follower counts. "false" returns URLs only (cheaper, no residential proxy). Sent as a string for Clay compatibility. | | `skipCache` | string | no | "false" | "true" forces a fresh lookup instead of the 7 day cache. | The actor processes one company per run. In Clay, map it to a column and it runs once per row automatically. For bulk processing, trigger one run per company; successful lookups are cached for 7 days, so repeat domains are near-instant. ### Output One flat row per company. Follower counts are strings to preserve formatting like `1.2M` (counts are not always exact, see the coverage table). ```json { "company_domain": "stripe.com", "company_name": "Stripe", "platforms_checked": 5, "platforms_found": 5, "linkedin_url": "https://www.linkedin.com/company/stripe", "linkedin_followers": "1,490,661", "linkedin_discovery": "homepage_sameas", "linkedin_status": "ok", "x_url": "https://x.com/stripe", "x_followers": null, "x_discovery": "homepage_sameas", "x_status": "not_extractable", "instagram_url": "https://www.instagram.com/stripehq", "instagram_followers": "43K", "instagram_discovery": "homepage_sameas", "instagram_status": "ok", "facebook_url": "https://www.facebook.com/StripeHQ", "facebook_followers": "65K", "facebook_discovery": "homepage_sameas", "facebook_status": "ok", "youtube_url": "https://www.youtube.com/@Stripe", "youtube_followers": "107K", "youtube_discovery": "homepage_sameas", "youtube_status": "ok", "confidence": "high", "run_date": "2026-06-20T15:29:08.116Z" } ```` Per-platform `*_status` values: | Status | Meaning | | --- | --- | | `ok` | Profile found and follower count extracted. | | `url_only` | Profile found; counts were not requested. | | `not_extractable` | Profile found, but the count is not in the public HTML (always X; sometimes Instagram or Facebook). | | `blocked` | Profile exists but an anti-bot or login wall stopped the fetch. | | `not_found` | No official profile discovered. | ### Platform coverage | Platform | URL discovery | Follower count | Notes | | --- | --- | --- | --- | | LinkedIn | Yes | Yes | Company page followers. Residential proxy. | | YouTube | Yes | Yes (rounded) | Subscriber count is rounded by YouTube, e.g. `1.2M`. | | Instagram | Yes | Best-effort | Exact when available; some pages return null due to platform restrictions. | | Facebook | Yes | Best-effort | Exact when available; the modern Page format hides the count on some pages. | | X / Twitter | Yes | No | URL only. Follower counts require authentication, which this actor does not use. | Note: X/Twitter returns the profile URL with status `not_extractable`. Follower counts require authentication which this actor does not use. Note: Instagram and Facebook follower counts are best-effort. Some company pages return null due to platform restrictions; those rows carry status `not_extractable` or `blocked`, never an error. ### Pricing **$0.015 per company.** Pay per event, billed per company processed. No subscription, no seat license, no contract. | Companies | Cost | | --- | --- | | 100 | $1.50 | | 1,000 | $15.00 | | 10,000 | $150.00 | Paid Apify plans receive the standard tiered usage discounts. ### Free tier vs paid usage Free Apify-plan users get **50 results per calendar month**, tracked in a Key-Value Store in your own account and reset at the start of each month. When the limit is reached the run exits cleanly with an upgrade notice. Upgrade to any paid Apify plan for unlimited mapping: https://apify.com/pricing. Paid-plan runs are never capped and incur no usage tracking. ### Compliance This actor reads only public, company-level pages, uses no login and no API keys, and collects no personal data. It does not scrape personal profiles. X/Twitter is intentionally URL-only because reading its follower count would require an authenticated session. ### Use with MCP (AI agents) This actor is callable as a tool over MCP by AI clients like Claude Desktop, Cursor, VS Code (GitHub Copilot), and Windsurf. Apify hosts the MCP server at `mcp.apify.com`, so no custom server code is needed. ```json { "mcpServers": { "mamba-labs-social-mapper": { "url": "https://mcp.apify.com?tools=mambalabs/company-social-presence-mapper" } } } ``` Example prompts: - "Map the social presence of stripe.com and tell me its LinkedIn and YouTube follower counts." - "Find the official Instagram and Facebook pages for notion.so." MCP runs use the same pay-per-event pricing as direct API or Console runs. *** **Part of the [Mamba Labs GTM Intelligence Suite](https://apify.com/mambalabs)** | Actor | Actor ID | |-------|----------| | [GTM Hiring Signal Scraper](https://apify.com/mambalabs/gtm-hiring-signal-scraper) | D7O1SA2EqwHGsGr1P | | [GTM Tech Stack Signal Enrichment](https://apify.com/mambalabs/gtm-tech-stack-signal-scraper) | qyd7nNyqFPelQViBx | | [GTM Signals Aggregator](https://apify.com/mambalabs/gtm-signals-aggregator) | xKdRfnfFNkdMpFuNs | | [Job Board Keyword Signal Scanner](https://apify.com/mambalabs/job-board-keyword-signal-scanner) | 4DvqpvhMR74NLcDDY | | [Domain to LinkedIn URL Resolver](https://apify.com/mambalabs/domain-to-linkedin-url-resolver) | 3HtnSaqPHOg1Qg5gx | | [ICP Fit Scorer](https://apify.com/mambalabs/icp-fit-scorer) | W161DT8W4kW55dMFh | | [Domain Deliverability Checker](https://apify.com/mambalabs/domain-deliverability-checker) | 0tVgxI7A6o9jMlxmc | | [Company Firmographic Enricher](https://apify.com/mambalabs/company-firmographic-enricher) | YlUtLWjfPpqykmB8g | | [Company Social Presence Mapper](https://apify.com/mambalabs/company-social-presence-mapper) | 4k6CCemkgBDz18m2h | npm: [@mambalabsdev/ats-scrapers](https://www.npmjs.com/package/@mambalabsdev/ats-scrapers) Built by [Mamba Labs](https://apify.com/mambalabs). # Actor input Schema ## `company_domain` (type: `string`): Bare domain, e.g. stripe.com. Required if company\_name is not given. ## `company_name` (type: `string`): Improves search accuracy and disambiguation. ## `platforms` (type: `array`): Which platforms to map. Default: all five. X/Twitter returns URL only (follower count requires login, which this actor does not use). ## `includeFollowerCounts` (type: `string`): When "true" (default), fetches profile pages to extract follower counts. Set "false" for URL-only mapping (cheaper, no residential proxy needed). Sent as a string for Clay compatibility. ## `skipCache` (type: `string`): When "false" (default), a successful mapping is cached for 7 days and reused on repeat lookups. Set "true" to force a fresh lookup. Sent as a string for Clay compatibility. ## Actor input object example ```json { "company_domain": "stripe.com", "company_name": "Stripe", "platforms": [ "linkedin", "x", "instagram", "facebook", "youtube" ], "includeFollowerCounts": "true", "skipCache": "false" } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing official social URLs and follower counts for each input company. # 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 = { "company_domain": "stripe.com", "company_name": "Stripe" }; // Run the Actor and wait for it to finish const run = await client.actor("mambalabs/company-social-presence-mapper").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 = { "company_domain": "stripe.com", "company_name": "Stripe", } # Run the Actor and wait for it to finish run = client.actor("mambalabs/company-social-presence-mapper").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 '{ "company_domain": "stripe.com", "company_name": "Stripe" }' | apify call mambalabs/company-social-presence-mapper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mambalabs/company-social-presence-mapper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Company Social Presence Mapper - URLs + Followers for Clay", "description": "Resolves a company domain to its official LinkedIn, X, Instagram, Facebook, and YouTube URLs, plus follower counts where publicly accessible. Flat Clay-ready output with discovery method, per-platform status, and confidence scoring.", "version": "0.1", "x-build-id": "4N5e3Yx1n4QfHVXWi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~company-social-presence-mapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-company-social-presence-mapper", "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/mambalabs~company-social-presence-mapper/runs": { "post": { "operationId": "runs-sync-mambalabs-company-social-presence-mapper", "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/mambalabs~company-social-presence-mapper/run-sync": { "post": { "operationId": "run-sync-mambalabs-company-social-presence-mapper", "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", "properties": { "company_domain": { "title": "Company Domain", "type": "string", "description": "Bare domain, e.g. stripe.com. Required if company_name is not given." }, "company_name": { "title": "Company Name", "type": "string", "description": "Improves search accuracy and disambiguation." }, "platforms": { "title": "Platforms", "type": "array", "description": "Which platforms to map. Default: all five. X/Twitter returns URL only (follower count requires login, which this actor does not use).", "items": { "type": "string", "enum": [ "linkedin", "x", "instagram", "facebook", "youtube" ] }, "default": [ "linkedin", "x", "instagram", "facebook", "youtube" ] }, "includeFollowerCounts": { "title": "Include Follower Counts", "enum": [ "true", "false" ], "type": "string", "description": "When \"true\" (default), fetches profile pages to extract follower counts. Set \"false\" for URL-only mapping (cheaper, no residential proxy needed). Sent as a string for Clay compatibility.", "default": "true" }, "skipCache": { "title": "Skip Cache", "enum": [ "false", "true" ], "type": "string", "description": "When \"false\" (default), a successful mapping is cached for 7 days and reused on repeat lookups. Set \"true\" to force a fresh lookup. Sent as a string for Clay compatibility.", "default": "false" } } }, "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 } } } } } } } } } } ```