# LinkedIn Companies

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

**Pricing:** $3 / 1k companies

**Endpoint:** `POST /api/v1/agents/linkedin/companies/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companies` | array | No | LinkedIn company URLs to fetch. One per line. |
| `query` | string | No | Keywords to find LinkedIn companies (e.g. 'fintech startup'). |
| `locations` | array | No | Filter to companies in these locations (e.g. 'San Francisco'). One per line. |
| `companySize` | array | No | Filter to companies in this employee-count band. |
| `industries` | array | No | Filter to companies in this industry. |
| `maxResults` | integer | No | Max companies to return per search query. Ignored when company URLs are passed. |

## Example

```bash
curl -X POST https://api.mindcase.co/api/v1/agents/linkedin/companies/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/linkedin/companies/run",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {}},
)
data = resp.json()
```

## Get the results

`run` is async and returns a `job_id`. Poll until `status` is `completed`, then read the rows:

```bash
# 1) check status
curl https://api.mindcase.co/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/api/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, SDKs, MCP): https://mindcase.co/skills.md

## Response columns

| Field | Display name | Type |
|-------|--------------|------|
| `linkedinUrl` | LinkedIn URL | url |
| `companyName` | Company Name | text |
| `tagline` | Tagline | text |
| `description` | Description | text |
| `website` | Website | url |
| `phone` | Phone | phone |
| `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 |