# LinkedIn Company (`linkedin.company`)

Full LinkedIn company page from a company URL or universal name: description, industry, headcount and size band, followers, founding date, headquarters and offices, specialities, funding and similar companies.

Docs: https://primaryapi.com/docs/api-reference/linkedin/company

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.company`
- Category: Social · Platform: `linkedin` · Kind: lookup · Status: live
- Price: 2 credits per call; up to 6 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.company`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `url` | string | yes |  | max 2048 chars | LinkedIn company page URL (https://www.linkedin.com/company/<slug>) or its universal name, e.g. "shopify". |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `id` | string \| null | LinkedIn numeric company id |
| `universalName` | string \| null | Company slug in linkedin.com/company/<universalName> |
| `name` | string \| null |  |
| `url` | string \| null | Company page URL |
| `linkedinUrl` | string \| null | Company page URL (same as url) |
| `tagline` | string \| null |  |
| `description` | string \| null |  |
| `website` | string \| null |  |
| `logoUrl` | string \| null |  |
| `coverImage` | string \| null | Cover (background) image URL |
| `industry` | string \| null | Primary industry |
| `industries` | string[] | Every industry the page lists |
| `companyType` | string \| null | e.g. "Public Company", "Privately Held" |
| `employeeCount` | integer \| null | Headcount shown on the page (members who list the company) |
| `employeeCountRange` | object \| null | Company size band, e.g. { start: 10001, end: null } or text "10,001+ employees" |
| `employeeCountRange.start` | integer \| null |  |
| `employeeCountRange.end` | integer \| null |  |
| `employeeCountRange.text` | string \| null |  |
| `followerCount` | integer \| null |  |
| `foundedOn` | object \| null |  |
| `foundedOn.year` | integer \| null |  |
| `foundedOn.month` | integer \| null |  |
| `foundedOn.day` | integer \| null |  |
| `headquarter` | object \| null |  |
| `headquarter.text` | string \| null | Location as one line, e.g. "Los Gatos, CA, United States" |
| `headquarter.line1` | string \| null |  |
| `headquarter.city` | string \| null |  |
| `headquarter.geographicArea` | string \| null | State, province or region |
| `headquarter.country` | string \| null | Country code or name as LinkedIn shows it |
| `headquarter.postalCode` | string \| null |  |
| `headquarter.headquarter` | boolean \| null | True for the headquarters office |
| `headquarter.description` | string \| null | Office label, e.g. "Headquarters" |
| `city` | string \| null | Headquarters city |
| `country` | string \| null | Headquarters country |
| `line1` | string \| null | Headquarters street line |
| `postalCode` | string \| null | Headquarters postal code |
| `locations` | object[] |  |
| `locations[].text` | string \| null | Location as one line, e.g. "Los Gatos, CA, United States" |
| `locations[].line1` | string \| null |  |
| `locations[].city` | string \| null |  |
| `locations[].geographicArea` | string \| null | State, province or region |
| `locations[].country` | string \| null | Country code or name as LinkedIn shows it |
| `locations[].postalCode` | string \| null |  |
| `locations[].headquarter` | boolean \| null | True for the headquarters office |
| `locations[].description` | string \| null | Office label, e.g. "Headquarters" |
| `specialities` | string[] |  |
| `fundingData` | object \| null | Funding summary when the page shows one |
| `fundingData.numberOfRounds` | integer \| null |  |
| `fundingData.lastRound` | object \| null |  |
| `fundingData.lastRound.type` | string \| null |  |
| `fundingData.lastRound.date` | string \| null |  |
| `fundingData.lastRound.amount` | string \| null |  |
| `fundingData.investors` | object[] |  |
| `fundingData.investors[].name` | string \| null |  |
| `fundingData.investors[].url` | string \| null |  |
| `fundingData.crunchbaseUrl` | string \| null |  |
| `similarOrganizations` | object[] |  |
| `similarOrganizations[].name` | string \| null |  |
| `similarOrganizations[].url` | string \| null |  |
| `similarOrganizations[].logoUrl` | string \| null |  |
| `pageVerified` | boolean \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/linkedin.company" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/company/shopify"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "id": "string",
      "universalName": "string",
      "name": "string",
      "url": "https://www.linkedin.com/company/shopify",
      "linkedinUrl": "https://example.com",
      "tagline": "string",
      "description": "string",
      "website": "string",
      "logoUrl": "https://example.com",
      "coverImage": "string",
      "industry": "string",
      "industries": [
        "string"
      ],
      "companyType": "string",
      "employeeCount": 0,
      "employeeCountRange": {
        "start": 0,
        "end": 0,
        "text": "string"
      },
      "followerCount": 0,
      "foundedOn": {
        "year": 0,
        "month": 0,
        "day": 0
      },
      "headquarter": {
        "text": "string",
        "line1": "string",
        "city": "string",
        "geographicArea": "string",
        "country": "string",
        "postalCode": "string",
        "headquarter": true,
        "description": "string"
      },
      "city": "string",
      "country": "string",
      "line1": "string",
      "postalCode": "string",
      "locations": [
        {
          "text": "string",
          "line1": "string",
          "city": "string",
          "geographicArea": "string",
          "country": "string",
          "postalCode": "string",
          "headquarter": true,
          "description": "string"
        }
      ],
      "specialities": [
        "string"
      ],
      "fundingData": {
        "numberOfRounds": 0,
        "lastRound": {
          "type": "string",
          "date": "string",
          "amount": "string"
        },
        "investors": [
          {
            "name": "string",
            "url": "https://www.linkedin.com/company/shopify"
          }
        ],
        "crunchbaseUrl": "https://example.com"
      },
      "similarOrganizations": [
        {
          "name": "string",
          "url": "https://www.linkedin.com/company/shopify",
          "logoUrl": "https://example.com"
        }
      ],
      "pageVerified": true
    }
  },
  "provider": "PrimaryAPI",
  "credits": 2,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## Pricing and reliability

- Usual price: 2 credits per call
- Price ceiling: up to 6 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.company`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Fields LinkedIn does not show on the public page come back null: follower count, office addresses and funding are not available for every company. Pages that do not exist, or show nothing, are misses and are not charged.

## Legal

Public LinkedIn data only. LinkedIn’s User Agreement restricts automated collection and LinkedIn enforces it; use the data for lawful purposes, keep copies only as long as you need them, and treat post and article text as the author’s content (analysis, not republication).

