# Linkedin Company Scraper (`vynux/linkedin-company-scraper`) Actor
Extract structured LinkedIn company data at scale - no browser, no scraping delays. Submit any company URL and get back a full profile instantly: name, tagline, description, industry, type, founded year, headquarters, all office locations, employee count, followers, website, specialties and more.
- **URL**: https://apify.com/vynux/linkedin-company-scraper.md
- **Developed by:** [Vynux](https://apify.com/vynux) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.40 / 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
## LinkedIn Company Data API
### What does LinkedIn Company Data API do?
**LinkedIn Company Data API** lets you instantly retrieve structured data for any LinkedIn company, showcase page, or school — without touching LinkedIn's website directly. Built on a continuously updated database of **20 million+ companies**, it returns rich company profiles in seconds for most requests.
Paste in any LinkedIn company URL, get back a full JSON profile: company name, industry, headquarters, employee count, follower count, description, specialties, logo, affiliated pages, and more. When a company isn't in the database yet, the Actor triggers a **live scrape** and returns the result — usually within 60 seconds.
Run it on the [Apify platform](https://apify.com) for instant access via API, scheduled runs, no-code integrations, and automatic result storage.
---
### Why use LinkedIn Company Data API?
- **20M+ companies pre-indexed** — most lookups return instantly from cache
- **Bulk lookups** — submit hundreds of URLs in a single run
- **No browser automation required** — fast, reliable, no bot detection issues
- **Live scraping fallback** — missing companies are scraped on demand and added to the database
- **Structured output** — clean JSON ready to pipe into your CRM, data warehouse, or enrichment pipeline
- **Apify integrations** — connect to Google Sheets, Zapier, Make, Slack, and more out of the box
**Common use cases:**
- Lead enrichment — fill in company details from a list of LinkedIn URLs
- Market research — collect industry, size, and location data at scale
- Competitive intelligence — monitor company profiles and affiliated pages
- Sales prospecting — qualify accounts before outreach
- Data pipelines — keep your CRM or database fresh with scheduled runs
---
### How to use LinkedIn Company Data API
1. **Open the Actor** on the Apify platform and click **Try for free**
2. **Paste LinkedIn URLs** into the *LinkedIn Company URLs* field — one per line. Any of these formats work:
- `https://www.linkedin.com/company/ibm/`
- `https://www.linkedin.com/company/1009` *(numeric ID)*
- `https://www.linkedin.com/showcase/microsoft-azure/`
- `https://www.linkedin.com/school/harvard-university/`
3. **Choose data mode**: leave *Real-time data* disabled for instant results, or enable it to fetch the latest data (useful for recently founded companies or recently changed profiles)
4. **Click Start** and watch results appear in the **Output** tab in real time
5. **Export** your results as JSON, CSV, or Excel — or connect them directly to your tools via the Apify API
---
### Input
| Field | Type | Required | Description |
|---|---|---|---|
| `urls` | Array of strings | Yes | LinkedIn company, showcase, or school URLs to look up |
| `realtime` | Boolean | No | Fetch the most up-to-date data (default: `false`). Enable for new or recently changed companies |
**Example input (JSON):**
```json
{
"urls": [
"https://www.linkedin.com/company/ibm/",
"https://www.linkedin.com/company/1009",
"https://www.linkedin.com/showcase/microsoft-azure/"
],
"realtime": false
}
````
***
### Output
Results are pushed to the **Dataset** as they complete — you can watch them appear in the Output tab during the run. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.
**Example output item:**
```json
{
"_id": "66513b46b71f457f85b2dcb1",
"company_prooflink_name": "https://www.linkedin.com/company/ibm/",
"company_prooflink_id": "https://www.linkedin.com/company/1009",
"company_name": "IBM",
"tagline": null,
"description": "At IBM, we do more than work. We create as technologists, developers, and engineers...",
"industry": "IT Services and IT Consulting",
"website_by_prooflink": "http://www.ibm.com",
"domain_by_prooflink": "ibm.com",
"company_size_min": 10001,
"company_size_max": null,
"company_size_exact": null,
"registered_employees": 327474,
"followers_count": 19351212,
"headquarters": "Armonk, New York, NY",
"company_type": "Public Company",
"founded_year": null,
"locations": ["International Business Machines Corp., New Orchard Road, Armonk, NY 10504, US"],
"specialties": ["Cloud", "Watson", "Analytics", "Consulting", "Security"],
"company_logo": "https://media.licdn.com/dms/image/...",
"background_cover_image_url": "https://media.licdn.com/dms/image/...",
"affiliated_companies": [
"https://www.linkedin.com/showcase/ibmconsulting/",
"https://www.linkedin.com/showcase/ibm-cloud/"
],
"website_actual": "https://www.ibm.com/us-en",
"domain_actual": "ibm.com",
"website_status": "valid",
"creation_time": "2026-04-01T06:49:27.870000"
}
```
Failed lookups (invalid URLs or companies that could not be retrieved) are also included in the dataset with an `error` field instead of company data.
***
### Data fields
| Field | Type | Description |
|---|---|---|
| `company_name` | String | Official company name as listed on LinkedIn |
| `tagline` | String | Short tagline shown on the company page |
| `description` | String | Full company description |
| `industry` | String | LinkedIn industry classification |
| `company_type` | String | e.g. Public Company, Privately Held, Nonprofit |
| `founded_year` | Integer | Year the company was founded |
| `headquarters` | String | Primary office location |
| `company_size_min` | Integer | Lower bound of the employee range shown on LinkedIn |
| `company_size_max` | Integer | Upper bound of the employee range (null for 10001+) |
| `registered_employees` | Integer | Exact registered employee count on LinkedIn |
| `followers_count` | Integer | Number of LinkedIn followers |
| `website_by_prooflink` | String | Website URL extracted from the LinkedIn page |
| `website_actual` | String | Resolved final website URL after redirects |
| `domain_actual` | String | Clean domain extracted from the website |
| `specialties` | Array | List of specialties listed by the company |
| `locations` | Array | All office locations listed on the page |
| `affiliated_companies` | Array | LinkedIn URLs of affiliated and showcase pages |
| `company_logo` | String | URL of the company logo image |
| `background_cover_image_url` | String | URL of the profile background image |
| `company_prooflink_name` | String | Canonical LinkedIn URL (name format) |
| `company_prooflink_id` | String | Canonical LinkedIn URL (numeric ID format) |
| `creation_time` | String | ISO timestamp of when this record was last scraped |
***
### How much does it cost?
Apify charges based on compute time. This Actor is optimised to be as fast as possible:
- **Cached lookups** — most runs complete in under 5 seconds regardless of how many URLs you submit. A batch of 1,000 cached companies typically costs **less than $0.01**
- **Fresh scrapes** (`cache: false`) — the Actor waits for live scraping to complete, which adds ~10–60 seconds per company. A batch of 100 companies being scraped fresh typically costs **$0.05–0.20** depending on run time
You can test the Actor for free within your Apify plan's included compute units before committing to larger runs.
***
### Tips
- **Two-pass enrichment** — run with `realtime: false` first to get instant results for known companies, then resubmit only the failed/missing ones with `realtime: true`
- **Deduplicate your input** — the Actor deduplicates URLs automatically, but cleaner input means faster processing
- **Use numeric IDs when you have them** — `https://www.linkedin.com/company/1009` is a stable identifier that won't break if a company changes its name slug
- **Showcase pages work too** — pass `https://www.linkedin.com/showcase/ibm-cloud/` the same way as a regular company URL
- **Schedule recurring runs** — use Apify Schedules to re-enrich your database weekly with fresh data
***
### FAQ & Support
**Is scraping LinkedIn legal?**
This Actor accesses only publicly available LinkedIn company pages — the same information visible to any unauthenticated visitor. We do not scrape personal data, private profiles, or any content behind a login wall. Users are responsible for ensuring their use complies with LinkedIn's Terms of Service and applicable laws in their jurisdiction.
**What if a company isn't found?**
If a company isn't in our database and can't be scraped (private page, invalid URL, LinkedIn login required), it will appear in the output with an `error` field explaining why.
**What URL formats are supported?**
Name slugs (`/company/ibm/`), numeric IDs (`/company/1009`), showcase pages (`/showcase/name/`), and school pages (`/school/name/`). Extra query parameters and non-standard subdomains are stripped automatically.
**The data looks stale — how do I get fresh data?**
Enable `realtime` in your input. Any company last updated more than 24 hours ago will be refreshed automatically.
**Found a bug or need a custom solution?**
Open an issue in the Issues tab on this Actor's page. For enterprise volume, custom fields, or private deployments, reach out directly.
# Actor input Schema
## `urls` (type: `array`):
One or more LinkedIn company URLs to look up. Supports /company/, /showcase/, and /school/ URL types. Both name slugs and numeric ID formats are accepted — extra query parameters and non-standard subdomains are cleaned automatically.
## `realtime` (type: `boolean`):
When enabled, fetches the most up-to-date data for each company. Recommended for new or recently changed companies. Adds ~10–60 seconds per company. Leave disabled for faster results.
## Actor input object example
```json
{
"urls": [
"https://www.linkedin.com/company/ibm/",
"https://www.linkedin.com/company/1009",
"https://www.linkedin.com/showcase/microsoft-azure/"
],
"realtime": false
}
```
# Actor output Schema
## `companies` (type: `string`):
Structured LinkedIn company profiles. Each item contains company name, industry, size, location, follower count, specialties, affiliated pages, and more. Items with an error field indicate URLs that could not be retrieved.
# 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 = {
"urls": [
"https://www.linkedin.com/company/ibm/",
"https://www.linkedin.com/company/1009",
"https://www.linkedin.com/showcase/microsoft-azure/"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("vynux/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 = { "urls": [
"https://www.linkedin.com/company/ibm/",
"https://www.linkedin.com/company/1009",
"https://www.linkedin.com/showcase/microsoft-azure/",
] }
# Run the Actor and wait for it to finish
run = client.actor("vynux/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 '{
"urls": [
"https://www.linkedin.com/company/ibm/",
"https://www.linkedin.com/company/1009",
"https://www.linkedin.com/showcase/microsoft-azure/"
]
}' |
apify call vynux/linkedin-company-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=vynux/linkedin-company-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Linkedin Company Scraper",
"description": "Extract structured LinkedIn company data at scale - no browser, no scraping delays. Submit any company URL and get back a full profile instantly: name, tagline, description, industry, type, founded year, headquarters, all office locations, employee count, followers, website, specialties and more.",
"version": "0.0",
"x-build-id": "Ff7FPHBzVL6rweMku"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vynux~linkedin-company-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vynux-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/vynux~linkedin-company-scraper/runs": {
"post": {
"operationId": "runs-sync-vynux-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/vynux~linkedin-company-scraper/run-sync": {
"post": {
"operationId": "run-sync-vynux-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": [
"urls"
],
"properties": {
"urls": {
"title": "LinkedIn Company URLs",
"minItems": 1,
"uniqueItems": true,
"type": "array",
"description": "One or more LinkedIn company URLs to look up. Supports /company/, /showcase/, and /school/ URL types. Both name slugs and numeric ID formats are accepted — extra query parameters and non-standard subdomains are cleaned automatically.",
"default": [
"https://www.linkedin.com/company/ibm/"
],
"items": {
"type": "string"
}
},
"realtime": {
"title": "Real-time data",
"type": "boolean",
"description": "When enabled, fetches the most up-to-date data for each company. Recommended for new or recently changed companies. Adds ~10–60 seconds per company. Leave disabled for faster results.",
"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
}
}
}
}
}
}
}
}
}
}
```