nv.searchCompanies

This action allows you to search for companies in Sales Navigator applying various filtering criteria.

Constraints

Parameters

{
  "actionType": "nv.searchCompanies",
  "label": "techIncSearch1",
  "term": "Tech Inc",
  "limit": 2,
  "filter": {
    "sizes": ["51-200", "2001-500"],
    "locations": ["San Francisco", "New York"],
    "industries": ["Software Development", "Robotics Engineering"],
    "annualRevenue": {
      "min": "0",
      "max": "2.5"
    }
  },
  "customSearchUrl": "https://www.linkedin.com/sales/search/company?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3ALinked%2520API)",
  "then": { ... }
}

• label (optional) – custom label for tracking this action in workflow completion.
• term (optional) – keyword or phrase to search.
• limit (optional) – number of search results to return. Defaults to 25, with a maximum value of 1000.
• filter (optional) – object that specifies filtering criteria for companies. When multiple filter fields are specified, they are combined using AND logic.
  • sizes (optional) – array of enums representing employee count ranges. Matches if company’s size falls within any of the listed ranges. Options:
    • 1-10.
    • 11-50.
    • 51-200.
    • 201-500.
    • 501-1000.
    • 1001-5000.
    • 5001-10000.
    • 10001+.
  • locations (optional) – array of free-form strings representing locations. Matches if company is headquartered in any of the listed locations.
  • industries (optional) – array of enums representing industries. Matches if company operates in any of the listed industries. Takes specific values available in the LinkedIn interface.
  • annualRevenue (optional) – object representing company annual revenue range in million USD:
    • min – enum with options:
      • 0.
      • 0.5.
      • 1.
      • 2.5.
      • 5.
      • 10.
      • 20.
      • 50.
      • 100.
      • 500.
      • 1000.
    • max – enum with options:
  • 0.5.
  • 1.
  • 2.5.
  • 5.
  • 10.
  • 20.
  • 50.
  • 100.
  • 500.
  • 1000.
  • 1000+.
• 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.
• then (optional) – object or array of child actions to be executed within this action.

Result options

1. Successful search:

{
  "actionType": "nv.searchCompanies",
  "label": "techIncSearch1",
  "success": true,
  "data": [
    {
      "name": "TechCorp",
      "hashedUrl": "https://www.linkedin.com/company/12345678",
      "industry": "Information Technology",
      "employeesCount": 500,
      "then": { ... }
    },
    {
      "name": "Techical Life",
      "hashedUrl": "https://www.linkedin.com/company/87654321",
      "industry": "Software Development",
      "employeesCount": 120,
      "then": { ... }
    }
  ]
}

• label – included only if specified in the action parameters.
• data – array of search outputs with results of child actions execution.
  • name – name of the company.
  • hashedUrl – hashed LinkedIn URL of the company.
  • industry – enum representing the company industry. Takes specific values available in the LinkedIn interface.
  • employeesCount – total number of employees associated with the company.
  • then – results of child actions execution.

2. Failed search:

{
  "actionType": "nv.searchCompanies",
  "label": "techIncSearch1",
  "success": false,
  "error": {
    "type": "noSalesNavigator",
    "message": "Your account does not have Sales Navigator subscription."
  }
}

• label – included only if specified in the action parameters.
• error.type – enum with the following possible values:
  • noSalesNavigator – your account does not have Sales Navigator subscription.
  • searchingNotAllowed – LinkedIn has blocked performing the search due to exceeding limits or other restrictions.