# search_people: Search people

Search people on ordinary LinkedIn by plain words, a place name and connection degree. This action only reads; it changes nothing. Plan: Free and Connect.

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

{
  "keywords": "head of sales"
}
```

## What you give it

- `keywords` (optional): text, up to 300 characters. Words to search for, e.g. "head of sales fintech".
- `location` (optional): text, up to 100 characters. A place name, e.g. "Berlin" or "United Kingdom".
- `network` (optional): a list (one of: first, second, third), up to 3. Limit to these connection degrees from you: first, second, third.
- `limit` (optional): a number, 1 to 10. Max people to return (1–10, 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_people`.
- `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`
- `total`
- `hasMore`
- `nextCursor`: a cursor
- `applied`
- `people`
- `note`

## Good to know

- location is a place NAME here; the action looks its id up itself. Every other LinkedIn filter is on search_linkedin_people.
- At most 10 rows per call: LinkedIn's page size for this search.

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