Search LinkedIn
OPT-IN ONLY: use this ONLY when the user explicitly asks to search LinkedIn with their own connected account - it runs as their real LinkedIn seat and spends its daily search quota.
Tool: search_linkedin
Default prospecting goes through search_people / search_companies. The call stages results and returns search_id without creating CRM rows or a group. Continue with continue_search and commit approved rows with save_search. NOT for: leads already in the CRM → search_people.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
query | string | no | Keywords, e.g. head of growth fintech. One of query / url / connections_of / filters is required. Alias: keywords. |
url | string | no | OR paste a LinkedIn / Sales Navigator search URL. Cannot be combined with filters. |
connections_of | string | no | Exact person name - search their connections (1st-degree only). |
filters | object | no | Structured filters. location / industry / company / past_company / school take names (auto id-resolution; ambiguous names are rejected with candidates), numeric ids, lists, or {include, exclude} objects; any other Unipile search field passes through raw (profile_language, company_headcount, seniority, tenure, groups, ...). |
network | string or string[] | no | first | second | third - one value or a list. |
category | string | no | people (default) | companies. |
api | string | no | classic | sales_navigator - defaults to the best the seat has. |
limit | integer | no | Per page: 50 classic / 100 sales_navigator. Default: 25. |
exclude_lead_group | string (slug or UUID) | no | Skip existing people by LinkedIn URL or companies by stable domain. |
connected_account_id | string (slug or UUID) | no | Seat to search as. Alias: account_id. Default: the only connected seat. |
Opt-in only - call this only when the user explicitly asks to search LinkedIn with their own connected account. It runs as their real LinkedIn seat and spends its per-day search budget. Default prospecting goes through
search_people/search_companies.Results are staged under a durable
search_id; pass the returnedsearch_versiontocontinue_searchfor one next page.After explicit approval, the first
save_searchmust provide exactly one ofgroup_nameorlead_group_id. Destination-free saves are valid only after the search is bound.NOT for leads already in the CRM - use
search_people.
Sample request — success
{
"query": "head of growth fintech",
"network": "second",
"limit": 10
}Sample request — filters
{
"query": "gtm",
"network": "first",
"filters": {
"location": "United States",
"profile_language": [
"en"
]
}
}