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

# Search for LinkedIn people

`POST /linkedin/search-people`

## Request

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

Search for people on LinkedIn for a given keywords, locations, and other criteria

## Request body

- object
  - `keywords` string: Keywords to search for in people profiles
  - `locations` string[]: List of locations to filter the search
  - `titles` string[]: List of job titles to filter the search
  - `seniorities` string[]: List of seniority levels to filter the search
  - `company_sizes` LinkedInCompanySize[]: List of company size ranges to filter the search
  - `company_industries` LinkedInCompanyIndustry[]: List of company industry tags to filter the search
  - `company_domains` string[]: List of company domains to filter the search
  - `page` integer: Page number for pagination (default is 1)

## Response `200`

SearchPeople API successful response

- object
  - `people` LinkedInPerson[]
    - `url` string, uri: URL to the person's profile
    - `name` string: Full name of the person
    - `location` string: Location of the person
    - `title` string, nullable: Job title of the person
    - `company_name` string: Name of the company the person works for
    - `company_url` string, uri: URL to the company profile
    - `experiences` object[]: List of experiences or previous job roles of the person
      - `title` string, nullable
      - `company_name` string
      - `start_date` string, nullable
      - `end_date` string, nullable

## Other responses

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

## Changes

- **2024-11-26** `4564942657b8`: 1 info
  - the request property `keywords` became optional
- **2024-11-19** `d52d4c23f66e`: 2 breaking
  - the response property `people/items/experiences/items/title` became nullable for the status `200`
  - the response property `people/items/title` became nullable for the status `200`
- **2024-11-10** `3e444ff2fa41`: 3 breaking, 167 info
  - request property `company_industries/items/` was restricted to a list of enum values
  - request property `company_sizes/items/` was restricted to a list of enum values
  - request property `seniorities/items/` was restricted to a list of enum values
  - added the new `1-10` enum value to the request property `company_sizes/items/`
  - …166 more
- **2024-11-05** `57c3c3ae1e29`: 2 breaking
  - the response property `people/items/experiences/items/end_date` became nullable for the status `200`
  - the response property `people/items/experiences/items/start_date` became nullable for the status `200`

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/linkedin/search-people/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)