nvSearchPeople

This method allows you to search for people in Sales Navigator applying various filtering criteria.

try {
  const workflowId = await linkedapi.nvSearchPeople.execute({
    term: "Product Manager",
    limit: 10,
    filter: {
      firstName: "John",
      lastName: "Doe",
      position: "Product Manager",
      locations: ["San Francisco", "New York"],
      industries: ["Software Development", "Technology"],
      currentCompanies: ["Google", "Microsoft"],
      previousCompanies: ["Apple"],
      schools: ["Stanford University", "MIT"],
      yearsOfExperience: ["threeToFive", "sixToTen"]
    },
    customSearchUrl: "https://www.linkedin.com/sales/search/people?query=(recentSearchParam%3A(doLogHistory%3Atrue)%2CspellCorrectionEnabled%3Atrue%2Ckeywords%3ABill%2520Gates)"
  });
  
  const { data, errors } = await linkedapi.nvSearchPeople.result(workflowId);
  
  // The list of possible execution errors is below
  if (errors && errors.length > 0) {
    console.warn('Workflow completed with execution errors:');
    errors.forEach(error => {
      console.warn(` - Type: ${error.type}, Message: ${error.message}`);
    });
  }
  if (data) {
    console.log('Search completed successfully.');
    console.log('Found people:', data);
  }
} catch (e) {
  // A list of all critical errors can be found here:
  // https://linkedapi.io/sdks/handling-results-and-errors/#handling-critical-errors
  if (e instanceof LinkedApiError) {
    console.error(`Critical Error - Type: ${e.type}, Message: ${e.message}`);
  } else {
    console.error('An unexpected, non-API error occurred:', e);
  }
}

# Python SDK is coming soon!
#
# You can always use Linked API through HTTP
# https://linkedapi.io/docs/

// Go SDK is coming soon!
//
// You can always use Linked API through HTTP
// https://linkedapi.io/docs/

Params

• term – (optional) keyword or phrase to search for.
• limit – (optional) number of search results to return. Defaults to 25, with a maximum value of 2500.
• filter (optional) – object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using AND logic.
  • firstName (optional) – first name of person.
  • lastName (optional) – last name of person.
  • position (optional) – job position of person.
  • locations (optional) – array of free-form strings representing locations. Matches if person is located in any of the listed locations.
  • industries (optional) – array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.
  • currentCompanies (optional) – array of company names. Matches if person currently works at any of the listed companies.
  • previousCompanies (optional) – array of company names. Matches if person previously worked at any of the listed companies.
  • schools (optional) – array of institution names. Matches if person currently attends or previously attended any of the listed institutions.
  • yearsOfExperience (optional) – array of enums representing professional experience. Matches if person’s experience falls within any of the listed ranges. Options:
    • lessThanOne – less than 1 year.
    • oneToTwo – 1 to 2 years.
    • threeToFive – 3 to 5 years.
    • sixToTen – 6 to 10 years.
    • moreThanTen – more than 10 years.
• customSearchUrl (optional) – URL copied from Sales Navigator search results page after configuring desired filters. When specified, overrides term and filter parameters. Allows using any search configuration available in Sales Navigator.

Data

Array of search results. Each search result contains:

• name – full name of the person.
• hashedUrl – hashed LinkedIn URL of the person.
• position – job position of the person.
• location – free-form string indicating the person's location.

Errors

• noSalesNavigator – your account does not have Sales Navigator subscription.
• searchingNotAllowed – LinkedIn has blocked performing the search due to exceeding limits or other restrictions.