> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search People

> Search for profiles using various filters.

## Overview

Search for profiles using a combination of keyword, company, location, school, and other filters. Supports pagination for retrieving large result sets.

There are two ways to define the search — pick whichever fits:

1. **Friendly filters** — pass human-readable values (e.g. `location: "Paris"`, `title: "CEO"`) and the API resolves them to the underlying ids for you.
2. **Copied LinkedIn search URL** — build the search visually on LinkedIn, copy the page URL, and pass it as `search_url`. Every filter is replicated verbatim, including ones with no friendly mapping (service category, profile language, open to volunteering, school free text, …).

> [!NOTE]
>
> This endpoint consumes **1 credit per 10 results** returned. Ignore this if you're on per-seat pricing: usage is unlimited.

## Request

**x-api-key** `string` *required*

Your API key for authentication.

**account\_id** `string` *required*

The unique identifier of the account to use.

**action** `string` *required*

Must be `"search_people"`.

**params** `object`

**params properties**

**search\_url** `string`

A copied LinkedIn people search URL (`https://www.linkedin.com/search/results/people/?...`), pasted as-is. When provided, its filters are used as-is and **take precedence** over the friendly filters below. The best way to replicate a complex search or to use filters that have no friendly mapping. Returns `INVALID_PARAMS` if the URL is not a people search or carries no filter at all.

To list an event's attendees, pass the URL behind the event page's attendee list (`https://www.linkedin.com/search/results/people/?eventAttending=%5B%22<event_id>%22%5D`), not the `/events/<id>` page itself. LinkedIn only shows that list to accounts attending the event.

**keyword** `string`

General keyword to search for across profiles.

**first\_name** `string`

Filter by first name.

**last\_name** `string`

Filter by last name.

**title** `string`

Filter by current job title.

**company\_name** `string`

Filter by current company name.

**company\_url** `string | string[]`

Filter by company page URL, or a company id from [Typeahead](https://docs.linkupapi.com/api-reference/v2/profiles/typeahead.md). Accepts a single string or an array of strings for multiple companies.

**past\_company** `string | string[]`

Filter by past company name, URL or id. Accepts a single string or an array.

**location** `string | string[]`

Filter by location name (e.g., `"San Francisco"`, `["Paris", "London"]`) or location id from [Typeahead](https://docs.linkupapi.com/api-reference/v2/profiles/typeahead.md). Accepts a single string or an array.

**school\_url** `string | string[]`

Filter by school page URL or school id. Accepts a single string or an array.

**industry** `string | string[]`

Filter by industry. Accepts a single string or an array.

**network** `string | string[]`

Filter by network relationship. Accepted values: `"F"` (1st degree), `"S"` (2nd degree), `"O"` (3rd degree and beyond). Accepts a single string or an array (e.g., `["F", "S"]`).

**connection\_of** `string`

Filter to show connections of a specific profile (profile URL, identifier, or the id returned by Typeahead `people`).

**follower\_of** `string`

Filter to show followers of a specific company or profile.

**offset** `integer` (default: 0)

Index of the first result to return (0-based). Combine with `count` to paginate. Any value works — it does not have to align to a page boundary.

**count** `integer` (default: 10)

Number of results to return, starting at `offset`.

## Response

**success** `boolean`

Indicates whether the request was successful.

**data** `object`

**data properties**

**profiles** `array`

Matching profiles.

**profile properties**

**name** `string`

Full name.

**job\_title** `string`

Current headline / job title.

**connection\_level** `string`

Degree, e.g. `"1st degree"`, `"2nd degree"`.

**location** `string`

Geographic location.

**profile\_url** `string`

Profile URL.

**profile\_picture** `string`

Profile picture URL.

**total\_results** `integer`

Number of profiles returned.

**total\_available\_results** `integer`

Total number of matching profiles available.

```json 200 theme={null}
{
  "success": true,
  "data": {
    "profiles": [
      {
        "name": "Jane Doe",
        "job_title": "Growth Marketing Specialist",
        "connection_level": "2nd degree",
        "location": "Greater Nice Metropolitan Area",
        "profile_url": "https://www.linkedin.com/in/janedoe",
        "profile_picture": "https://media.licdn.com/dms/image/..."
      }
    ],
    "total_results": 1,
    "total_available_results": 15400
  },
  "metadata": {
    "action": "search_people",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.