---
title: "Search people"
method: POST
path: "/v1/actions/search_people"
tags: ["Search"]
---

# Search people

`POST /v1/actions/search_people`

## Request

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

Search people on ordinary LinkedIn by plain words, a place name and connection degree.

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.

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

## Request body

- object
  - `keywords` string: Words to search for, e.g. "head of sales fintech".
  - `location` string: A place name, e.g. "Berlin" or "United Kingdom".
  - `network` string[]: Limit to these connection degrees from you: first, second, third.
  - `limit` number: Max people 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, total, hasMore, nextCursor, applied, people, note.

- 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)