# LinkedIn Company Enrichment - Firmographics & Company Data (`thirdwatch/linkedin-company-enrichment-scraper`) Actor

Turn a LinkedIn company URL, slug, company name, or website domain into a structured firmographic record: industry, size band, employees on LinkedIn, followers, HQ address, all offices, founded year, company type, specialties, website and logo. Pure HTTP, no login required.

- **URL**: https://apify.com/thirdwatch/linkedin-company-enrichment-scraper.md
- **Developed by:** [Thirdwatch](https://apify.com/thirdwatch) (community)
- **Categories:** Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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.
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 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 Enrichment Scraper

> Turn a LinkedIn company URL, company name, or website domain into a structured firmographic record with industry, size, followers, headquarters, locations, specialties, and website details.

### What you get

Provide one or many companies and receive one consistent record for each resolved public LinkedIn company page. LinkedIn URLs and slugs are the most precise inputs; names and domains are useful when you are enriching an existing account list.

### Output fields

| Field | Description |
|---|---|
| `name` | Company name |
| `slug` / `company_id` | LinkedIn identifiers |
| `linkedin_url` | Canonical company-page URL |
| `tagline` / `description` | Public positioning and About text |
| `industry` | LinkedIn industry label |
| `company_size` | Published employee-size band |
| `employee_count_min` / `employee_count_max` | Parsed size-band bounds |
| `employees_on_linkedin` | Members who publicly list the company as employer |
| `follower_count` | Company-page followers |
| `founded_year` / `company_type` | Founding year and organization type |
| `specialties` | Self-declared specialties |
| `website` / `website_domain` | Company website details |
| `headquarters` | Formatted headquarters address |
| `hq_street`, `hq_city`, `hq_region`, `hq_postal_code`, `hq_country` | Headquarters components |
| `locations` / `locations_count` | Published office locations |
| `logo_url` / `banner_image_url` | Public brand images |
| `recent_post_count` / `latest_post_at` | Recent public activity signals |
| `source_query` / `scraped_at` | Input and collection timestamp |

### Example output

```json
{
  "name": "HashiCorp",
  "slug": "hashicorp",
  "linkedin_url": "https://www.linkedin.com/company/hashicorp/",
  "industry": "Software Development",
  "company_size": "1001-5000 employees",
  "employee_count_min": 1001,
  "employee_count_max": 5000,
  "follower_count": 250000,
  "founded_year": 2012,
  "company_type": "Public Company",
  "website": "https://www.hashicorp.com",
  "headquarters": "San Francisco, California, United States",
  "source_query": "hashicorp.com"
}
````

### Input parameters

| Parameter | Required | Description |
|---|---|---|
| `companies` | Yes | LinkedIn company URLs, slugs, company names, or website domains. |
| `maxResults` | No | Maximum companies to return. Default `10`. |
| `concurrency` | No | Companies processed at the same time. Default `10`. |
| `proxyConfiguration` | No | Connection settings. Keep the preconfigured default for most runs. |

### Use cases

- **Sales operations**: Fill missing firmographic fields in CRM account records.
- **Market research**: Compare industries, size bands, locations, and specialties across company cohorts.
- **Recruiting intelligence**: Segment target employers by size, industry, and geography.
- **Data teams**: Normalize mixed company names, domains, and LinkedIn URLs into one schema.

### Limitations

- Website-domain resolution is correct for roughly three in four tested companies; use LinkedIn URLs or slugs when precision matters.
- Common company names can resolve to a larger organization with the same name.
- Optional fields such as specialties, founded year, and employee counts are absent when the company has not published them.
- Only public company-page data is supported. Private and member-only information is out of scope.

### Compared to alternatives

- **vs. harvestapi company enrichment**: This actor accepts a mixed list of LinkedIn URLs, names, and domains and returns a compact firmographic record intended for account enrichment.
- **vs. LinkedIn Company Employees actors**: This actor returns company-level facts, not employee profiles. Pair the two when you need both account and people data.

### FAQ

**Which input is most reliable?**
A full LinkedIn company URL or exact slug. Names and domains are best-effort discovery inputs.

**Does it require a LinkedIn login?**
No. It collects fields published on public company pages.

**Can I process a mixed input list?**
Yes. URLs, slugs, names, and domains can appear in the same `companies` list.

Last verified: 2026-07

More company-data actors at [thirdwatch.dev](https://thirdwatch.dev).

# Actor input Schema

## `companies` (type: `array`):

One company per line. Accepts LinkedIn company URLs (https://www.linkedin.com/company/hashicorp/), bare LinkedIn slugs (hashicorp), company names (HashiCorp), or website domains (hashicorp.com). LinkedIn URLs and slugs resolve exactly; names and domains are resolved best-effort.

## `maxResults` (type: `integer`):

Maximum number of enriched company records to return. Each company page produces exactly one record.

## `concurrency` (type: `integer`):

How many companies to process at the same time. The default is recommended for most runs.

## `proxyConfiguration` (type: `object`):

Connection settings for reliable company-page collection. Keep the preconfigured default unless you have a specific requirement.

## Actor input object example

```json
{
  "companies": [
    "https://www.linkedin.com/company/hashicorp/"
  ],
  "maxResults": 10,
  "concurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "https://www.linkedin.com/company/hashicorp/",
        "stripe.com",
        "Datadog"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("thirdwatch/linkedin-company-enrichment-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "companies": [
        "https://www.linkedin.com/company/hashicorp/",
        "stripe.com",
        "Datadog",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("thirdwatch/linkedin-company-enrichment-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": [
    "https://www.linkedin.com/company/hashicorp/",
    "stripe.com",
    "Datadog"
  ]
}' |
apify call thirdwatch/linkedin-company-enrichment-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=thirdwatch/linkedin-company-enrichment-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "LinkedIn Company Enrichment - Firmographics & Company Data",
        "description": "Turn a LinkedIn company URL, slug, company name, or website domain into a structured firmographic record: industry, size band, employees on LinkedIn, followers, HQ address, all offices, founded year, company type, specialties, website and logo. Pure HTTP, no login required.",
        "version": "1.0",
        "x-build-id": "uDmcmcsj02kus8a50"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/thirdwatch~linkedin-company-enrichment-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-thirdwatch-linkedin-company-enrichment-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/thirdwatch~linkedin-company-enrichment-scraper/runs": {
            "post": {
                "operationId": "runs-sync-thirdwatch-linkedin-company-enrichment-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/thirdwatch~linkedin-company-enrichment-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-thirdwatch-linkedin-company-enrichment-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",
                        "type": "array",
                        "description": "One company per line. Accepts LinkedIn company URLs (https://www.linkedin.com/company/hashicorp/), bare LinkedIn slugs (hashicorp), company names (HashiCorp), or website domains (hashicorp.com). LinkedIn URLs and slugs resolve exactly; names and domains are resolved best-effort.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of enriched company records to return. Each company page produces exactly one record.",
                        "default": 10
                    },
                    "concurrency": {
                        "title": "Concurrency",
                        "minimum": 1,
                        "maximum": 30,
                        "type": "integer",
                        "description": "How many companies to process at the same time. The default is recommended for most runs.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Connection settings for reliable company-page collection. Keep the preconfigured default unless you have a specific requirement.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```