# search_linkedin: Search LinkedIn with any filter

Run a search from a results link copied out of LinkedIn, Sales Navigator or Recruiter. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/search_linkedin
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "url": "https://www.linkedin.com/search/results/people/?keywords=head%20of%20sales"
}
```

## What you give it

- `kind` (optional): one of: classic/people, classic/companies, classic/posts, classic/jobs, sales_navigator/people, sales_navigator/companies, recruiter/people. What to search. Required unless url is given.
- `filters` (optional): a group of fields. The search filters for that kind, e.g. { keywords: "head of sales", network_distance: [2], location: ["106967730"] }.
- `url` (optional): a link. A LinkedIn / Sales Navigator / Recruiter search URL to run instead of kind + filters.
- `limit` (optional): a number, 1 to 100. How many to return (1–100, default 10).
- `cursor` (optional): a cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same. Where to get it: The `nextCursor` from the last answer of `search_linkedin`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `returned`: number
- `nextCursor`: a cursor
- `results[].type`: JOB
- `results[].id`: string
- `results[].publicIdentifier`: string or null
- `results[].publicProfileUrl`: string or null
- `results[].profileUrl`: string
- `results[].profilePictureUrl`: string or null
- `results[].profilePictureUrlLarge`: string or null
- `results[].memberUrn`: string or null
- `results[].name`: string
- `results[].firstName`: string
- `results[].lastName`: string
- `results[].networkDistance`: SELF | DISTANCE_1 | DISTANCE_2 | DISTANCE_3 | OUT_OF_NETWORK
- `results[].location`: string or null
- `results[].industry`: string
- `results[].keywordsMatch`: string
- `results[].headline`: string
- `results[].connectionsCount`: number
- `results[].followersCount`: number
- `results[].pendingInvitation`: boolean
- `results[].canSendInmail`: boolean
- `results[].hiddenCandidate`: boolean
- `results[].interestLikelihood`: string
- `results[].recruiterCandidateId`: string
- `results[].recruiterPipelineCategory`: string
- `results[].premium`: boolean
- `results[].verified`: boolean
- `results[].sharedConnectionsCount`: number
- `results[].recentPostsCount`: number
- `results[].recentlyHired`: boolean
- `results[].mentionedInTheNews`: boolean
- `results[].interests`: string
- `results[].summary`: string or null
- `results[].jobOffersCount`: number
- `results[].headcount`: string
- `results[].socialId`: string
- `results[].shareUrl`: string
- `results[].title`: string
- `results[].text`: string
- `results[].date`: string
- `results[].parsedDatetime`: string
- `results[].reactionCounter`: number
- `results[].commentCounter`: number
- `results[].repostCounter`: number
- `results[].impressionsCounter`: number
- `results[].userReacted`: LIKE | PRAISE | APPRECIATION | EMPATHY | INTEREST | ENTERTAINMENT
- `results[].isRepost`: boolean
- `results[].repostId`: string
- `results[].repostParsedDatetime`: string
- `results[].referenceId`: string
- `results[].postedAt`: any or null
- `results[].reposted`: boolean
- `results[].url`: string
- `results[].promoted`: boolean
- `results[].benefits`: string[]
- `results[].easyApply`: boolean

## Good to know

- Use it for url. For filters use the typed actions (search_linkedin_people, …_companies, …_posts, …_jobs, …_sales_navigator_people, …_sales_navigator_companies, …_recruiter_people): this one takes them as a free-form object in LinkedIn's own snake_case names, unchecked.
- Rows are of the kind searched; their fields are those of the typed action for that kind.
- A limit above LinkedIn's page size for the kind searched is brought down to it: 10 for ordinary people and companies, 49 for posts, 50 for jobs, 100 on Sales Navigator and Recruiter. A pasted ordinary link does not say its kind and is held to 50.

Page: https://heyreagent.com/docs/actions/search_linkedin