---
title: "Search people, every filter typed"
method: POST
path: "/v1/actions/search_linkedin_people"
tags: ["Search"]
---

# Search people, every filter typed

`POST /v1/actions/search_linkedin_people`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/search_linkedin_people`
- Auth: HTTP bearer

Search people on ordinary LinkedIn, with each LinkedIn filter as its own typed input.

At most 10 rows per call: LinkedIn's page size for this search.

LinkedIn returns at most 1,000 rows for one search; narrow the filters to reach the rest.

publicIdentifier is not always a readable name: for some people a real search returned a string of 20 to 26 letters and digits. The link in publicProfileUrl works either way.

networkDistance in a row is defined as DISTANCE_1 / DISTANCE_2 / DISTANCE_3 (a published sample row also shows OUT_OF_NETWORK), while a profile reports FIRST_DEGREE / SECOND_DEGREE / THIRD_DEGREE for the same thing: do not compare the two as text.

Docs: https://heyreagent.com/docs/actions/search_linkedin_people

## Request body

- object
  - `keywords` string: Name, title, company or any words.
  - `industry` string[]: Industries: ids from lookup_search_ids type INDUSTRY.
  - `location` string[]: Places: ids from lookup_search_ids type LOCATION.
  - `profileLanguage` string[]: Profile languages, as two-letter codes such as "en".
  - `networkDistance` unknown[]: Connection degrees from you: 1, 2, 3.
    - unknown
  - `company` string[]: Current companies: ids from lookup_search_ids type COMPANY.
  - `pastCompany` string[]: Past companies: ids from lookup_search_ids type COMPANY.
  - `school` string[]: Schools: ids from lookup_search_ids type SCHOOL.
  - `service` string[]: Service categories they offer: ids from lookup_search_ids type SERVICE.
  - `connectionsOf` string[]: People whose connections to search: ids from lookup_search_ids type CONNECTIONS.
  - `followersOf` string[]: People whose followers to search: ids from lookup_search_ids type PEOPLE.
  - `openTo` string[]: Open to pro bono work or to a board seat.
  - `advancedKeywords` object: Words that must appear in one part of the profile: first name, last name, title, company or school.
    - `firstName` string
    - `lastName` string
    - `title` string
    - `company` string
    - `school` string
  - `limit` number: How many to return (1–10, default 10).
  - `cursor` string: nextCursor from the previous call, to get the next page. Keep the other arguments the same.
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: returned, nextCursor, results[].type, results[].id, results[].publicIdentifier, results[].publicProfileUrl, results[].profileUrl, results[].profilePictureUrl, results[].profilePictureUrlLarge, results[].memberUrn, results[].name, results[].firstName, results[].lastName, results[].networkDistance, results[].location, results[].industry, results[].keywordsMatch, results[].headline, results[].connectionsCount, results[].followersCount, results[].pendingInvitation, results[].canSendInmail, results[].hiddenCandidate, results[].interestLikelihood, results[].recruiterCandidateId, results[].recruiterPipelineCategory, results[].premium, results[].verified, results[].sharedConnectionsCount, results[].recentPostsCount, results[].recentlyHired, results[].mentionedInTheNews, results[].interests.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)