# LinkedIn Company Scraper (`santamaria-automations/linkedin-company-scraper`) Actor Extract companies from LinkedIn. Returns employee count, industry, headquarters, description, and specialties. Optional employee profile scraping. Pay-per-result. - **URL**: https://apify.com/santamaria-automations/linkedin-company-scraper.md - **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community) - **Categories:** Lead generation, AI, Automation - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## LinkedIn Company Scraper Enrich companies with LinkedIn data: employee count, industry, headquarters, description, specialties, website, founded year, follower count, top employees with profile URLs, and recent company posts. HTTP-only, no browser needed. ~128MB RAM, pay-per-result. ### How It Works 1. If `linkedin_url` is provided, the actor extracts the company slug directly (recommended). 2. If not provided, the actor searches Google via `GOOGLE_SERP` proxy to find the LinkedIn company page. 3. The actor scrapes the public LinkedIn guest page (`/organization-guest/company/{slug}`) which contains full company data in structured HTML. No login or cookies required. 4. Optionally scrapes the people page for employee profiles filtered by title. ### Use with AI Agents (MCP) Connect this actor to any MCP-compatible AI client: Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents. Apify MCP server URL: ```` https://mcp.apify.com?tools=santamaria-automations/linkedin-company-scraper ```` Example prompt once connected: > "Use `linkedin-company-scraper` to enrich these companies with LinkedIn data. Return the results as a table." Clients that support dynamic tool discovery (Claude.ai, VS Code) receive the full input schema automatically via `add-actor`. ### Input ```json { "companies": [ { "company_id": "acme-1", "company_name": "Example Company Ltd.", "linkedin_url": "https://www.linkedin.com/company/example-company" }, { "company_id": "acme-2", "company_name": "Sample Widgets GmbH", "website_domain": "sample-widgets.example" } ], "includeEmployees": true, "maxEmployeesPerCompany": 10, "employeeTitleFilters": ["HR", "CEO", "CTO"], "requestDelay": 3000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Input Fields | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `companies` | array | Yes | - | Companies to enrich | | `companies[].company_id` | string | Yes | - | Your internal identifier | | `companies[].company_name` | string | Yes | - | Company name | | `companies[].linkedin_url` | string | Recommended | - | Direct LinkedIn URL (skips search) | | `companies[].website_domain` | string | No | - | Improves search accuracy when no URL provided | | `includeEmployees` | boolean | No | `false` | Scrape employee profiles from people page | | `maxEmployeesPerCompany` | integer | No | `10` | Max employees per company (1-50) | | `employeeTitleFilters` | string\[] | No | `["HR","CEO","CTO","Recruiter","People","Talent"]` | Filter by title keywords | | `requestDelay` | integer | No | `2000` | Delay between requests in ms | | `linkedinCookie` | string | No | - | Optional li\_at cookie for authenticated access (more data) | | `linkedinEmail` | string | No | - | Optional: login to get li\_at automatically | | `linkedinPassword` | string | No | - | Optional: login password | ### Output Each company produces one dataset row: ```json { "company_id": "acme-1", "company_name": "Example Company Ltd.", "linkedin_url": "https://www.linkedin.com/company/example-company", "employee_count": 5000, "employee_count_range": "1,001-5,000", "industry": "Software Development", "headquarters": "Munich, Bavaria", "description": "Example Company Ltd. builds sample software for demo purposes.", "specialties": ["Sample Product", "Demo Service", "Widget Manufacturing"], "website": "https://www.example.com", "founded": "2015", "company_type": "Privately Held", "follower_count": 182760, "address": null, "employees": [ { "name": "Jane Doe", "title": "Head of People", "linkedin_url": "https://www.linkedin.com/in/jane-doe-example" } ], "posts": [ { "text": "We are hiring across our engineering teams.", "posted_at": "2d", "likes": null, "comments": null } ], "error": null } ``` #### Extracted Fields | Field | Description | |-------|-------------| | `employee_count` | Upper bound of employee range (e.g., 5000 for "1,001-5,000") | | `employee_count_range` | Raw range string from LinkedIn | | `industry` | Company industry | | `headquarters` | City, Region | | `description` | Full company description | | `specialties` | List of specialties or focus areas | | `website` | Company website URL | | `founded` | Year founded | | `company_type` | "Privately Held", "Public Company", etc. | | `follower_count` | LinkedIn follower count | | `employees` | Top visible employees with LinkedIn profile URLs | | `posts` | Up to 5 recent company updates | ### Pricing Pay-per-result via Apify Pay-Per-Event billing: | Event | Price | Description | |-------|-------|-------------| | Actor start | $0.001 | Charged once per run | | Company enriched | $0.005 | Charged per company row returned | Enriching 1,000 companies costs about $5, plus RESIDENTIAL proxy traffic. No monthly fees. ### Numeric LinkedIn IDs Older websites sometimes embed LinkedIn URLs in the numeric-ID form (for example `https://www.linkedin.com/company/19051`). LinkedIn walls those URLs behind a login page, so the actor probes a small set of candidate slugs built from `company_id` (typically the website domain) and `company_name`, and switches to the first slug URL that returns real company data. When this happens the output row sets `resolved_from_numeric_id: true`. If no candidate resolves, the row is emitted with `error: "numeric_id_unresolvable"` and no per-result charge is applied. ### Tips - Always provide `linkedin_url` when available. It is faster and more reliable than search. - LinkedIn URLs can be found on company websites (footer or header links), Google Maps data, or business directories. - The LinkedIn slug often differs from the legal company name (e.g., "Example Company AG" may map to `example-company`, not `example-company-ag`). - Use `requestDelay: 3000` or higher to avoid rate limiting (HTTP 999). - RESIDENTIAL proxy is required. Datacenter IPs get blocked. ### Use Cases - B2B Lead Enrichment: add employee counts, industry, and HQ to your company database. - Sales Intelligence: find decision-maker profiles via the employees list. - Market Research: analyze industry distribution, company sizes, and specialties across a list of companies. - Competitive Analysis: track competitor follower counts and recent posts. ### Related Actors Discovery: - [Google Maps Scraper](https://apify.com/santamaria-automations/google-maps-scraper) - collect places and companies in bulk Enrichment: - [Website Email Scraper](https://apify.com/santamaria-automations/website-email-scraper) - pull emails and phones from company sites - [Website Contact Extractor](https://apify.com/santamaria-automations/website-contact-extractor) - LLM-powered people extraction - [AI Icebreaker Generator](https://apify.com/santamaria-automations/ai-icebreaker) - one personalized cold-outreach line per business - [GBP Completeness Audit](https://apify.com/santamaria-automations/gbp-completeness-audit) - score Google Business Profiles for lead prioritization ### Issues & Feature Requests If a field is missing or looks off for a given company, open an issue on the actor's Issues tab and we will take a look. # Actor input Schema ## `companies` (type: `array`): List of companies to look up on LinkedIn. Provide linkedin\_url if known, otherwise we search by company name + domain. ## `includeEmployees` (type: `boolean`): Scrape employee profiles from the company's people page (limited without login) ## `maxEmployeesPerCompany` (type: `integer`): Maximum number of employee profiles to scrape per company ## `employeeTitleFilters` (type: `array`): Filter employees by title keywords (e.g., HR, CEO, CTO, Recruiter). Empty = all. ## `includePosts` (type: `boolean`): Also parse the last few company posts from the guest feed (post\_id, post\_url, text, published\_at, like\_count, comment\_count, share\_count, has\_image, has\_video). Useful for icebreakers and lead-scoring signals. Off by default to keep runs cheap. ## `maxPostsPerCompany` (type: `integer`): How many recent posts to return per company when includePosts is on. LinkedIn's guest feed exposes about 10 activity cards per company, so raising this above 10 rarely yields more data. ## `linkedinCookie` (type: `string`): Your LinkedIn li\_at session cookie. Get it from browser DevTools > Application > Cookies > linkedin.com > li\_at. Alternative to email/password login. ## `linkedinEmail` (type: `string`): LinkedIn login email. Used for programmatic login to get li\_at cookie automatically. May trigger 2FA. ## `linkedinPassword` (type: `string`): LinkedIn login password. ## `requestDelay` (type: `integer`): Delay between requests to avoid rate limiting ## `customData` (type: `object`): Custom data passed to webhook (campaign\_id, pipeline\_run\_id) ## `proxyConfiguration` (type: `object`): RESIDENTIAL proxy required for LinkedIn ## Actor input object example ```json { "companies": [ { "company_id": "test-1", "company_name": "Example Company Ltd.", "website_domain": "example.com" } ], "includeEmployees": false, "maxEmployeesPerCompany": 10, "employeeTitleFilters": [ "HR", "CEO", "CTO", "Recruiter", "People", "Talent" ], "includePosts": false, "maxPostsPerCompany": 5, "requestDelay": 2000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `defaultDataset` (type: `string`): Company enrichment data from LinkedIn including employee count, industry, and optionally employee profiles. # 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": [ { "company_id": "test-1", "company_name": "Example Company Ltd.", "website_domain": "example.com" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/linkedin-company-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 = { "companies": [{ "company_id": "test-1", "company_name": "Example Company Ltd.", "website_domain": "example.com", }] } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/linkedin-company-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 '{ "companies": [ { "company_id": "test-1", "company_name": "Example Company Ltd.", "website_domain": "example.com" } ] }' | apify call santamaria-automations/linkedin-company-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=santamaria-automations/linkedin-company-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LinkedIn Company Scraper", "description": "Extract companies from LinkedIn. Returns employee count, industry, headquarters, description, and specialties. Optional employee profile scraping. Pay-per-result.", "version": "1.0", "x-build-id": "pqKKW6p7GSNRzTwqN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~linkedin-company-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-linkedin-company-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/santamaria-automations~linkedin-company-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-linkedin-company-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/santamaria-automations~linkedin-company-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-linkedin-company-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": [ "companies" ], "properties": { "companies": { "title": "Companies to Enrich", "type": "array", "description": "List of companies to look up on LinkedIn. Provide linkedin_url if known, otherwise we search by company name + domain.", "items": { "type": "object", "required": [ "company_id", "company_name" ], "properties": { "company_id": { "title": "Company ID", "type": "string", "description": "Your internal company identifier (UUID or any string)" }, "company_name": { "title": "Company Name", "type": "string", "description": "Company name to search on LinkedIn" }, "website_domain": { "title": "Website Domain", "type": "string", "description": "e.g. example.com" }, "linkedin_url": { "title": "LinkedIn URL", "type": "string", "description": "Direct LinkedIn company URL if known" } } } }, "includeEmployees": { "title": "Include Employees", "type": "boolean", "description": "Scrape employee profiles from the company's people page (limited without login)", "default": false }, "maxEmployeesPerCompany": { "title": "Max Employees Per Company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of employee profiles to scrape per company", "default": 10 }, "employeeTitleFilters": { "title": "Employee Title Filters", "type": "array", "description": "Filter employees by title keywords (e.g., HR, CEO, CTO, Recruiter). Empty = all.", "default": [ "HR", "CEO", "CTO", "Recruiter", "People", "Talent" ], "items": { "type": "string" } }, "includePosts": { "title": "Include Recent Posts", "type": "boolean", "description": "Also parse the last few company posts from the guest feed (post_id, post_url, text, published_at, like_count, comment_count, share_count, has_image, has_video). Useful for icebreakers and lead-scoring signals. Off by default to keep runs cheap.", "default": false }, "maxPostsPerCompany": { "title": "Max Posts Per Company", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many recent posts to return per company when includePosts is on. LinkedIn's guest feed exposes about 10 activity cards per company, so raising this above 10 rarely yields more data.", "default": 5 }, "linkedinCookie": { "title": "LinkedIn Cookie (li_at)", "type": "string", "description": "Your LinkedIn li_at session cookie. Get it from browser DevTools > Application > Cookies > linkedin.com > li_at. Alternative to email/password login." }, "linkedinEmail": { "title": "LinkedIn Email", "type": "string", "description": "LinkedIn login email. Used for programmatic login to get li_at cookie automatically. May trigger 2FA." }, "linkedinPassword": { "title": "LinkedIn Password", "type": "string", "description": "LinkedIn login password." }, "requestDelay": { "title": "Request Delay (ms)", "minimum": 500, "type": "integer", "description": "Delay between requests to avoid rate limiting", "default": 2000 }, "customData": { "title": "Custom Data", "type": "object", "description": "Custom data passed to webhook (campaign_id, pipeline_run_id)" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "RESIDENTIAL proxy required for LinkedIn", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```