# Search LinkedIn people (Sales Navigator)

`needleSearchLinkedinPeopleSalesNavigator`

Search Sales Navigator leads with keywords or filters, including current and past company, company headcount and type, function, seniority, years of experience, groups, saved lists and personas, and Spotlights such as changed_jobs. Most filters also take an excluded form. Resolve filter ids with needleListLinkedinSearchParameters using service sales_navigator. Requires a Sales Navigator seat.

**Input**

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