# LinkedIn Company Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/linkedin/company/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/linkedin-company-info |

## Description

LinkedIn Company Info API. Fetch firmographics by LinkedIn slug, URL, company ID, or reverse domain lookup (`guideflow.com`). Industry, headcount, HQ, posts, and more.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/linkedin/company/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by LinkedIn username - Ferrari

```json
{
  "posts": [
    {
      "post_id": "7442991179371167745",
      "post_url": "https://www.linkedin.com/posts/ferrari_ferrari12cilindrispider-ferrari-activity-7442991179371167745-iqaJ"
    },
    {
      "post_id": "7442602811004973056",
      "post_url": "https://www.linkedin.com/posts/ferrari_museoenzoferrari-modena-museiferrari-activity-7442602811004973056-L0Lf"
    }
  ],
  "founded": 1947,
  "tagline": "Ferrari, Italian excellence that makes the world dream.",
  "website": "http://www.ferrari.com",
  "industry": "Motor Vehicle Manufacturing",
  "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQFQWtQAnYFMEA/company-logo_200_200/company-logo_200_200/0/1630655008326/ferrari_logo?e=2147483647&v=beta&t=FZyFfc6-ZOFhE715KLI-YtJBbLwDW3Zb3UYf8rNKrjs",
  "employees": [
    {
      "name": "Guido Bolognesi",
      "profile_url": "https://it.linkedin.com/in/guidob"
    },
    {
      "name": "Marco Villa",
      "profile_url": "https://ae.linkedin.com/in/marvilla"
    }
  ],
  "locations": [
    "Abetone inferiore Maranello, MO 41053, IT",
    "via Abetone inferiore n°4 Modena, MO 41100, IT"
  ],
  "company_id": 7050,
  "company_url": "https://it.linkedin.com/company/ferrari",
  "description": "Ferrari's story officially began in 1947 when its first road car, the 125 S, emerged from the gate of no. 4 Via Abetone Inferiore in Maranello.",
  "headquarter": {
    "city": "Maranello",
    "line1": "Abetone inferiore",
    "country": "IT",
    "postal_code": "41053"
  },
  "staff_count": 10951,
  "staff_range": "over-10k",
  "company_name": "Ferrari",
  "specialities": [
    "automotive",
    "racing",
    "retail",
    "innovation",
    "luxury",
    "italy",
    "exclusivity",
    "design",
    "engineering",
    "Formula 1"
  ],
  "follower_count": 2137342
}
```

### Reverse domain lookup - guideflow.com

```json
{
  "founded": null,
  "funding": null,
  "tagline": "Guide your users into the flow 🐤",
  "website": "https://guideflow.com",
  "industry": "Software Development",
  "logo_url": "https://media.licdn.com/dms/image/v2/D4E0BAQEi2bj10wgfqA/company-logo_200_200/company-logo_200_200/0/1665984513264/guideflow_logo",
  "locations": [
    "Union St San Francisco, California, US",
    "Avenue de la Grande Armée Paris, Île-de-France, FR"
  ],
  "company_id": 87238155,
  "company_url": "https://www.linkedin.com/company/guideflow",
  "description": "Create interactive demos & step-by-step guides to boost your productivity & conversion rate with Guideflow.",
  "headquarter": {
    "city": "San Francisco",
    "line1": "Union St",
    "country": "US",
    "postal_code": null
  },
  "staff_count": 20,
  "staff_range": "10-50",
  "company_name": "Guideflow",
  "specialities": null,
  "follower_count": 1832
}
```

## Documentation

## Overview
The **LinkedIn Company Info API** returns firmographic data from a LinkedIn company page: industry, headcount, HQ, specialities, follower count, employee samples, affiliated companies, and recent posts.

Identify the company with **`query`** (LinkedIn slug, URL, or numeric ID) or **`domain`** (reverse lookup from a website domain).

## Quickstart
```
GET https://api.piloterr.com/v2/linkedin/company/info?query=ferrari
GET https://api.piloterr.com/v2/linkedin/company/info?query=7050
GET https://api.piloterr.com/v2/linkedin/company/info?domain=guideflow.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | no* | LinkedIn slug, company URL, numeric ID, or school URL |
| `domain` | string | no* | Company website domain for reverse lookup |

*Provide **either** `query` **or** `domain`, not both.

## Input with `query`
| Format | Example |
|---|---|
| Slug | `ferrari` |
| Company URL | `https://www.linkedin.com/company/ferrari` |
| Numeric ID | `7050` |
| School URL | `https://www.linkedin.com/school/harvard-university/` |

## Reverse lookup with `domain`
When your pipeline only has a website, pass the bare domain and the API resolves the LinkedIn company slug from indexed company data.

| Format | Example |
|---|---|
| Bare domain | `guideflow.com` |
| Full URL | `https://www.guideflow.com` |

```
GET https://api.piloterr.com/v2/linkedin/company/info?domain=guideflow.com
```

Typical flow: CRM row with `website = guideflow.com` → call with `domain` → get `company_url`, `staff_count`, `industry`, `follower_count`.

## Response fields
| Field | Type | Description |
|---|---|---|
| `company_id` | number | LinkedIn numeric company ID |
| `company_name` | string | Display name |
| `company_url` | string | Canonical LinkedIn page URL |
| `logo_url` | string | Logo image URL |
| `website` | string | Company website |
| `tagline` | string | Headline / tagline |
| `description` | string | About text |
| `founded` | number | Year founded |
| `industry` | string | Industry label |
| `staff_count` | number | Declared employee count |
| `staff_range` | string | Band (`1-10`, `10-50`, … `over-10k`) |
| `follower_count` | number | LinkedIn followers |
| `headquarter` | object | HQ address (`city`, `line1`, `country`, `postal_code`) |
| `locations` | array | Office location strings |
| `specialities` | array | Speciality tags |
| `employees` | array | Sample profiles (`name`, `profile_url`) |
| `affiliated_companies` | array | Affiliated pages |
| `similar_companies` | array | LinkedIn-suggested competitors |
| `posts` | array | Last posts (`post_id`, `post_url`) |
| `funding` | object | Last funding round (when available) |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing input, invalid domain, or both `query` and `domain` sent |
| `404` | Company not found for the given `query` or `domain` |
| `500` | Fetch or parse error |

## Notes
- **`domain`** is the fastest path when enriching from website lists, signup domains, or email `@company.com` roots.
- Do not send `query` and `domain` in the same request.
- `funding` comes from Crunchbase when LinkedIn exposes it.

## Main use cases
- Enrich CRM accounts from a `domain` or `website` column without manual LinkedIn search
- Resolve target accounts from prospect website lists to LinkedIn firmographics
- Monitor competitor headcount, industry, and follower trends via slug or ID
- Feed ABM workflows: domain → LinkedIn company → downstream people search