API Reference

Company industry

The Company industry (company_industry) filter enables the discovery of companies based on their Veridion industry.

The "company's industry" is a business classification value derived from Veridion's internal taxonomies. This categorization is the outcome of Machine Learning models Veridion has developed to organize companies within our database into approximately 200 distinct business industries.


Retrieving the Business Industry list

Veridion offers a dedicated API that provides a hierarchical structure including both industries and categories.

This enables you to access up-to-date information to input in the value field of the filter (see the Search modes below) and ensures that your search queries stay in sync with our database.

You can read more about this API in the Retrieving Veridion industries API section.


Search modes

Exact match

This mode is helpful when you are looking to discover companies based on a single, specific business industry. To run an exact match search, use equals in the relation parameter and input the industry name you are looking for in the value field.

In the example below, the filter returns all companies in the “Software & IT Services” industry.

{
  "attribute": "company_industry",
  "relation": "equals",
  "value": "Software & IT Services"
}

Multiple exact match

To search for multiple industries simultaneously, input the industries as an array under the value parameter and set the relation to in. The API will return all the companies with an industry matching any of the provided inputs.

For example, the following filter returns all companies in the "Software & IT Services" or "Media Companies" industries.

{
  "attribute": "company_industry",
  "relation": "in",
  "value": ["Software & IT Services", "Media Companies"]
}

Exclude industries

You can also use the relation parameter to filter out specific industries from the search. You have two options: use "not_equals" to exclude a single industry, or "not_in" to exclude all the industries from a list.

In the example below, the industries listed in the value parameter ("Software & IT Services" and "Media Companies") will be excluded from the search.

{
  "attribute": "company_industry",
  "relation": "not_in",
  "value": ["Software & IT Services", "Media Companies"]
}

📖

Reference

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