API Reference

Company employee count

The Company employee count (company_employee_count) filter allows you to filter companies based on an exact or approximate headcount.

📖

Source

Headcount can be either extracted from publicly available sources (e.g. website of the company, when mentioned, news snippets or other digital footprint), or modelled by Veridion proprietary AI models.

📘

Note

This filter will only return company profiles for which we have recorded employee counts in our database.


Search modes

Exact match

This search mode is useful when you want to discover companies of a particular size, based on their exact headcount. To conduct an exact match search, use the equals attribute in the relation parameter.

In the example below, the filter will retrieve companies with a recorded headcount of 1000 employees.

{
  "attribute": "company_employee_count",
  "relation": "equals",
  "value": 1000
}

Employee count range

For a broader range, you can use the between attribute for the relation parameter. This will return all companies with a headcount defined in an interval. To specify the range, input the minimum and maximum values as a tuple in the value parameter.

In the example below, the search will retrieve all companies with an employee count between 100 and 150. 

{
  "attribute": "company_employee_count",
  "relation": "between",
  "value": [100, 150]
}

Other limits

You can set superior or inferior limits in your filter by using the greater_than, greater_than_or_equal, less_than or less_than_or_equal relations.

In the example below, the filter will only search companies with an employee count greater or equal to 500.

{
  "attribute": "company_employee_count",
  "relation": "greater_than",
  "value": 500
}

📖

Reference

To view all available filter relations and accepted types, please check the Filter Relations section.