---
title: "Search for LinkedIn companies"
method: POST
path: "/linkedin/search-companies"
tags: ["LinkedIn"]
---

# Search for LinkedIn companies

`POST /linkedin/search-companies`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/linkedin/search-companies`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/linkedin/search-companies/post.ts> (a function with typed inputs; its response is checked against the schema)

Search for companies on LinkedIn for a given name, locations, and other criteria

## Request body

- object
  - `name` string: The name of the company to search for
  - `locations` string[]: List of locations to filter the search
  - `sizes` LinkedInCompanySize[]: List of company sizes to filter the search
  - `industries` LinkedInCompanyIndustry[]: List of industry tags to filter the search
  - `page` integer: Page number for pagination (default is 1)

## Response `200`

SearchCompanies API successful response

- object
  - `companies` object[]
    - `url` string, uri, nullable: URL to the company's profile
    - `uid` string, nullable: LinkedIn uid
    - `name` string: Name of the company
    - `website_url` string, uri, nullable: Company's website URL

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2024-11-10** `3e444ff2fa41`: 2 breaking, 156 info
  - request property `industries/items/` was restricted to a list of enum values
  - request property `sizes/items/` was restricted to a list of enum values
  - added the new `1-10` enum value to the request property `sizes/items/`
  - added the new `10001+` enum value to the request property `sizes/items/`
  - …154 more
- **2024-11-05** `57c3c3ae1e29`: 3 breaking
  - the response property `companies/items/uid` became nullable for the status `200`
  - the response property `companies/items/url` became nullable for the status `200`
  - the response property `companies/items/website_url` became nullable for the status `200`

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/linkedin/search-companies/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)