# Search Sales Navigator people

### Search Sales Navigator people

`POST /api/v1/linkedin/sales-navigator/people/search`

Operation ID: `searchLinkedinSalesNavigatorPeople`

Search Sales Navigator leads with keywords, focused structured filters, or a Sales Navigator people search URL.

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `keywords` (string, optional)
- `firstName` (string, optional): Matches the first name on the profile.
- `lastName` (string, optional): Matches the last name on the profile.
- `locations` (string[], optional): Geography ids from the search parameters endpoint with type=REGION and service=sales_navigator.
- `excludedLocations` (string[], optional): Geographies to leave out of the results.
- `industries` (string[], optional): Industry ids from the search parameters endpoint with type=SALES_INDUSTRY and service=sales_navigator.
- `excludedIndustries` (string[], optional): Industries to leave out of the results.
- `companies` (string[], optional): Current-company ids from the search parameters endpoint with type=COMPANY and service=sales_navigator.
- `excludedCompanies` (string[], optional): Current companies to leave out of the results.
- `pastCompanies` (string[], optional): Past-company ids from the search parameters endpoint with type=COMPANY and service=sales_navigator.
- `excludedPastCompanies` (string[], optional): Past companies to leave out of the results.
- `companyLocations` (string[], optional): Where the company sits, rather than where the person does. Geography ids with type=REGION and service=sales_navigator.
- `excludedCompanyLocations` (string[], optional): Company geographies to leave out of the results.
- `companyHeadcounts` ("1_to_10" | "11_to_50" | "51_to_200" | "201_to_500" | "501_to_1000" | "1001_to_5000" | "5001_to_10000" | "10001_plus"[], optional): Employee-count bands of the current company.
- `companyTypes` ("public_company" | "privately_held" | "non_profit" | "educational_institution" | "partnership" | "self_employed" | "self_owned" | "government_agency"[], optional): How the current company is held.
- `schools` (string[], optional): School ids from the search parameters endpoint with type=SCHOOL and service=sales_navigator.
- `excludedSchools` (string[], optional): Schools to leave out of the results.
- `functions` (string[], optional): The department someone works in. Function ids from the search parameters endpoint with type=DEPARTMENT and service=sales_navigator.
- `excludedFunctions` (string[], optional): Functions to leave out of the results.
- `jobTitles` (string[], optional): Current job-title ids from the search parameters endpoint with type=JOB_TITLE and service=sales_navigator.
- `excludedJobTitles` (string[], optional): Current job titles to leave out of the results.
- `pastJobTitles` (string[], optional): Job titles someone used to hold. Ids with type=JOB_TITLE and service=sales_navigator.
- `excludedPastJobTitles` (string[], optional): Past job titles to leave out of the results.
- `seniorities` ("owner_partner" | "cxo" | "vice_president" | "director" | "experienced_manager" | "entry_level_manager" | "strategic" | "senior" | "entry_level" | "in_training"[], optional): Seniority levels to search, from owner_partner down to in_training.
- `excludedSeniorities` ("owner_partner" | "cxo" | "vice_president" | "director" | "experienced_manager" | "entry_level_manager" | "strategic" | "senior" | "entry_level" | "in_training"[], optional): Seniority levels to leave out of the results.
- `yearsOfExperience` ("less_than_1" | "1_to_2" | "3_to_5" | "6_to_10" | "more_than_10"[], optional): Years of experience across someone's whole career.
- `yearsAtCompany` ("less_than_1" | "1_to_2" | "3_to_5" | "6_to_10" | "more_than_10"[], optional): Years spent at the current company.
- `yearsInPosition` ("less_than_1" | "1_to_2" | "3_to_5" | "6_to_10" | "more_than_10"[], optional): Years spent in the current position.
- `groups` (string[], optional): LinkedIn groups the person belongs to. Group ids with type=GROUPS and service=sales_navigator.
- `personas` (string[], optional): Personas saved on the Sales Navigator seat. Ids with type=PERSONA and service=sales_navigator.
- `accountLists` (string[], optional): Only people at companies on these saved account lists. Ids with type=ACCOUNT_LISTS and service=sales_navigator.
- `excludedAccountLists` (string[], optional): Saved account lists to leave out of the results.
- `leadLists` (string[], optional): Only people on these saved lead lists. Ids with type=LEAD_LISTS and service=sales_navigator.
- `excludedLeadLists` (string[], optional): Saved lead lists to leave out of the results.
- `connectionsOf` (string[], optional): Member ids from the search parameters endpoint with type=CONNECTIONS. Returns people connected to them.
- `profileLanguages` (string[], optional): ISO 639-1 profile-language codes from the search parameters endpoint with type=LANGUAGE.
- `networkDistances` (number[], optional): LinkedIn connection degrees: first, second, or third-plus.
- `spotlights` ("changed_jobs" | "posted_on_linkedin" | "mentioned_in_news" | "following_your_company" | "viewed_your_profile_recently" | "past_colleague" | "shared_experiences"[], optional): Sales Navigator's Spotlights: recent signals about the person rather than facts about their profile.
- `interactedWith` ("messaged" | "viewed_profile"[], optional): Only people this seat has messaged, or whose profile it opened.
- `includeSaved` ("leads" | "accounts"[], optional): Also return people already saved as leads, or at saved accounts.
- `searchUrl` (string · uri, optional): Use a lead search URL copied from Sales Navigator, such as https://www.linkedin.com/sales/search/people?query=.... The filters it carries replace the filter fields, which must then be left out. Standard LinkedIn URLs go to POST /api/v1/linkedin/people/search.
- `cursor` (string, optional)
- `limit` (integer, optional)

**200**: Search hits and an optional cursor.

- `hits` (object[], required)
- `cursor` (string | null, required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload