> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_linkedin_people

# search_linkedin_people

> People on LinkedIn by name, title, company, school or location, ten per page with headline and URL. ₹0.48 per page.

## What it does

Public LinkedIn profiles matching `search` (a name), `title`, `currentCompany`, `pastCompany`, `school`, `location` or `geoId`, ten per page in `data.elements[]` with `name`, `position` (the headline), `location`, `linkedinUrl` and `publicIdentifier`, and `data.pagination` with the total. Use it to find the right person before [`get_linkedin_profile`](https://parel.si/docs/tools/get_linkedin_profile.md) or [`find_email`](https://parel.si/docs/tools/find_email.md); it returns the search card only.

India: pass `location: "India"` or a city; company filters take the company's LinkedIn URL or id.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `page` | string | no | Page number, use for pagination. e.g. 1 |
| `geoId` | string | no | Filter by location as LinkedIn Geo ID. Overrides the location query param |
| `title` | string | no | Filter by title |
| `school` | string | no | Filter by school ID or School URL. One value or multiple comma-separated |
| `search` | string | no | Search profiles by name. e.g. "Bill Gates" |
| `lastName` | string | no | Filter by last name |
| `location` | string | no | Filter by location text |
| `firstName` | string | no | Filter by first name |
| `followerOf` | string | no | Filter profiles that are followers of a LinkedIn profile. Provide the profile URL or ID. One value or multiple comma-separated |
| `industryId` | string | no | Filter by industry ID. One value or multiple comma-separated |
| `pastCompany` | string | no | Filter by past company ID or Company URL. One value or multiple comma-separated |
| `currentCompany` | string | no | Filter by company ID or Company URL. One value or multiple comma-separated |
| `keywordsSchool` | string | no | Filter by keywords in school name |
| `keywordsCompany` | string | no | Filter by keywords in company name |

## What drives the cost

Nothing: flat per page whatever matches. `page` (a string, "2") fetches the next ten; each page is a call. No matches is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹0.48** per page (`cost_paise: 48`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.72 (`hold_paise: 72`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_linkedin_people"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_linkedin_people"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_linkedin_people","input":{"page":"1","search":"Jane Example"}}'
```

## What comes back

`data.elements[]` and `data.pagination`. A real answer recorded during the live check of 2026-10-28 (people's names, profile links and ids replaced by fictional ones), trimmed to two people:

```json
{
  "pagination": {
    "totalElements": 17,
    "totalPages": 2,
    "pageNumber": 1,
    "previousElements": 0,
    "pageSize": 10,
    "totalResultCount": 17
  },
  "elements": [
    {
      "id": "ACoAAAJaneExample0000000000000000000000",
      "name": "Jane Example",
      "position": "Building things.",
      "photo": "https://media.licdn.com/dms/image/v2/D5603AQHa3fM3oM6EXA/profile-displayphoto-scale_100_100/B56Z4hsEpdIsAY-/0/1778681664495",
      "location": {
        "linkedinText": "Gurugram"
      },
      "linkedinUrl": "https://www.linkedin.com/in/jane-example",
      "publicIdentifier": "jane-example"
    },
    {
      "id": "ACoAAAJaneExampleTwo0000000000000000000",
      "name": "Jane Example",
      "position": "Fellow at UCLA",
      "location": {
        "linkedinText": "Los Angeles, CA"
      },
      "linkedinUrl": "https://www.linkedin.com/in/jane-example",
      "publicIdentifier": "jane-example-2"
    },
    "… 8 more item(s) truncated"
  ],
  "query": {
    "search": "Jane%20Example",
    "page": "1"
  },
  "status": 200,
  "retries": 0,
  "originalQuery": {
    "search": "Jane Example",
    "page": "1"
  }
}
```

## Notes

- Ten profiles per page; page 2, 3... for more, each a call.
- Search card only: name, headline, location, URL. get_linkedin_profile reads the rest.
- Usually one to three seconds.

## Siblings

- [`get_linkedin_profile`](https://parel.si/docs/tools/get_linkedin_profile.md) for the full profile of a result.
- [`domain_search`](https://parel.si/docs/tools/domain_search.md) for everyone with a known email at the company.
