Search people
search_peopleUse this when the user wants to find people: by a plain-language description (such as "operations directors at logistics companies in Portugal"), by filters, by a saved search, or one person by LinkedIn URL. Send exactly one of query, filters, savedSearchId or savedSearchName. Returns one page of people with their job, company and location, and the filters the search ran with; for the next page, send those filters with the page's next cursor. People never carry an email address or a phone number: finding those is a separate, paid enrichment. Costs $0.001 per person returned, charged to the organization's balance; a page with nobody on it is free. Calling again with the same arguments charges again.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_people"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | People per page. The page's most possible cost, `limit` times $0.001, is held from your balance first. | |
| query | No | Who to find, in plain language. It is turned into filters, which the page answers with as `filters`. | |
| cursor | No | The `pagination.nextCursor` of the page before. Send it with the same search, as the `filters` the first page answered with. | |
| detail | No | How much of each row to return. `short` (the default) leaves out the long fields; `full` returns every field, so ask for few rows with it. | short |
| filters | No | Filters by name. Each filter's allowed values are listed with the people filters; free-text filters (job titles, companies, websites, locations, regions, schools, skills) take a suggested value. | |
| linkedinUrl | No | Look up one person by a LinkedIn profile URL, `in/<slug>` or the bare slug. It counts as a search on its own, or narrows one. | |
| savedSearchId | No | Run a saved people search by its id. | |
| savedSearchName | No | Run a saved people search by its title. A title several saved searches share answers 409 `saved_search_name_ambiguous`. |