> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Companies API

> Get LinkedIn company data by company URL, or by searching with filters (location, size, industry). Returns the full company profile either way.

`POST /v1/data/linkedin/companies/run`

**Pricing:** $0.004 per companie ($4.00 per 1,000).

## Ways to call it

* **URL**: set `companies`
* **Search**: set `query` (optional: `maxResults`, `locations`, `companySize`, `industries`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**companies** `string[]`

LinkedIn company URLs to fetch. One per line.

**query** `string`

Keywords to find LinkedIn companies (e.g. 'fintech startup').

**locations** `string[]`

Filter to companies in these locations (e.g. 'San Francisco'). One per line.

**companySize** `string[]`

Filter to companies in this employee-count band.

Allowed values: `1-10` (1-10 employees), `11-50` (11-50 employees), `51-200` (51-200 employees), `201-500` (201-500 employees), `501-1000` (501-1000 employees), `1001-5000` (1001-5000 employees), `5001-10000` (5001-10000 employees), `10001+` (10001+ employees).

**industries** `string[]`

Filter to companies in this industry.

434 allowed values, for example `2190` (Accommodation Services), `34` (Accommodation Services > Food and Beverage Services), `2217` (Accommodation Services > Food and Beverage Services > Bars, Taverns, and Nightclubs), `2212` (Accommodation Services > Food and Beverage Services > Caterers), `2214` (Accommodation Services > Food and Beverage Services > Mobile Food Services), `32` (Accommodation Services > Food and Beverage Services > Restaurants), `31` (Accommodation Services > Hospitality), `2197` (Accommodation Services > Hospitality > Bed-and-Breakfasts, Hostels, Homestays), `2194` (Accommodation Services > Hospitality > Hotels and Motels), `1912` (Administrative and Support Services). Fetch the full list with `GET /v1/data/linkedin/companies?expand=options`.

**maxResults** `integer`

Max companies to return (up to 1,000). Ignored when company URLs are passed.

Max `1000`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/linkedin/companies/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "companies": [
      "https://www.linkedin.com/company/openai/",
      "https://www.linkedin.com/company/meta/",
      "https://www.linkedin.com/company/google/"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/linkedin/companies/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "companies": [
        "https://www.linkedin.com/company/openai/",
        "https://www.linkedin.com/company/meta/",
        "https://www.linkedin.com/company/google/"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/linkedin/companies/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "companies": [
    "https://www.linkedin.com/company/openai/",
    "https://www.linkedin.com/company/meta/",
    "https://www.linkedin.com/company/google/"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one companie, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `linkedinUrl` | LinkedIn URL | url |
| `companyId` | Company ID | text |
| `companySlug` | Company Slug | text |
| `logo` | Logo | image |
| `companyName` | Company Name | text |
| `tagline` | Tagline | text |
| `description` | Description | text |
| `website` | Website | url |
| `ctaUrl` | CTA URL | url |
| `foundedYear` | Founded Year | number |
| `employeeCount` | Employee Count | number |
| `employeeCountRange` | Employee Count Range | text |
| `followers` | Followers | number |
| `industry` | Industry | text |
| `industryCategory` | Industry Category | text |
| `hqStreet` | HQ Street | text |
| `hqCity` | HQ City | text |
| `hqState` | HQ State | text |
| `hqCountry` | HQ Country | text |
| `hqPostalCode` | HQ Postal Code | text |
| `locations` | Locations | object\_array |
| `specialities` | Specialities | array |
| `activeStatus` | Active Status | boolean |
| `pageType` | Page Type | text |
| `jobsUrl` | Jobs URL | url |
| `employeesByLocation` | Employees by Location | object\_array |
| `verified` | Verified | boolean |
| `employeesBySchool` | Employees by School | object\_array |
| `employeesByFunction` | Employees by Function | object\_array |
| `employeesBySkill` | Employees by Skill | object\_array |
| `employeesByFieldOfStudy` | Employees by Field of Study | object\_array |
| `employeesByServiceCategory` | Employees by Service Category | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "linkedin/companies",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "logo": "https://media.licdn.com/dms/image/v2/D4D0BAQGGGyEKDfVyxg/company-logo_400_400/company-logo_400_400/0/1687168642942/nucleus_software_exports_limited_logo?e=17...",
      "employeesByLocation": [
        {
          "location": "India",
          "count": 2495
        },
        {
          "location": "Uttar Pradesh, India",
          "count": 1598
        }
      ],
      "locations": [
        {
          "street": "Sector 62",
          "city": "Noida",
          "state": "Uttar Pradesh",
          "country": "India",
          "postalCode": "201307"
        }
      ],
      "employeesByServiceCategory": [
        {
          "serviceCategory": "Software Development",
          "count": 22
        },
        {
          "serviceCategory": "Design",
          "count": 12
        }
      ],
      "employeeCountRange": "1001–5000",
      "employeesByFieldOfStudy": [
        {
          "fieldOfStudy": "Computer Science",
          "count": 589
        },
        {
          "fieldOfStudy": "Computational Science",
          "count": 573
        }
      ],
      "companyName": "Nucleus Software",
      "followers": 115441,
      "pageType": "COMPANY",
      "hqState": "Uttar Pradesh",
      "industry": "Software Development",
      "activeStatus": true,
      "employeesBySkill": [
        {
          "skill": "Java",
          "count": 897
        },
        {
          "skill": "SQL",
          "count": 874
        }
      ],
      "foundedYear": 1986,
      "hqCountry": "India",
      "tagline": "One of the first FinTechs born in India 🇮🇳\nWe help BFSI with lending, cash management & digital transformation.",
      "linkedinUrl": "https://www.linkedin.com/company/nucleus-software-exports-limited/",
      "companyId": "165256",
      "industryCategory": "Software Development",
      "employeesByFunction": [
        {
          "function": "Engineering",
          "count": 1607
        },
        {
          "function": "Information Technology",
          "count": 397
        }
      ],
      "hqCity": "Noida",
      "description": "Nucleus Software is the leading provider of lending and transaction banking solutions to the global financial services industry. Its software powers the oper...",
      "ctaUrl": "https://www.nucleussoftware.com/contact-us",
      "jobsUrl": "https://www.linkedin.com/jobs/search?geoId=92000000&f_C=165256",
      "website": "https://www.nucleussoftware.com"
    }
  ]
}
```

## Related APIs

To turn a website domain into its LinkedIn company page use [`linkedin/domain-lookup`](https://docs.mindcase.co/apis/linkedin/domain-lookup); to list a company's employees use [`linkedin/company-employees`](https://docs.mindcase.co/apis/linkedin/company-employees).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.