The Company proximity filter enables you to find companies within a specific radius of a geographical location. This is useful for identifying potential suppliers, partners, or competitors in proximity to a specific address.

📘

Note

This filter supports searching for both main and secondary locations of a company.

📖

Main vs. secondary locations

  • Main location

A company's main location refers to its headquarters or primary place of business. It is typically the central hub where the company's core operations are managed, and key decisions are made.

  • Secondary locations

Secondary locations include all other places where the company maintains a business presence, such as regional offices, branch locations, factories, or stores. These locations reflect the geographic extent of a company's operations beyond its main location.


Search modes

Lookup within specified radius

To enable lookup within a radius, you need to provide the following information:

  • An origin address: The reference location for your proximity search. The API will work with any level of specificity and format, for example:
    • Partial address: Amsterdam, Netherlands or abbreviated TX, L4P2E1, US
    • Full Address: 430 THE QUEENSWAY S GEORGINA ON L4P2E1 CA

      📘

      Note

      The address can be partial, as exemplified above, but it must include at least a city or postcode to ensure enough geographical detail for a radius lookup.

  • The radius: The distance from the address to search within. Must be a positive numerical value. Maximum value is 500 km / 300 miles, to enable both Urban/Local and Regional/National searches.
  • The distance unit: Either km ( kilometers ) or mi ( miles )

For example, if you are looking for companies in a 2 kilometers radius from Toronto, Ontario, M5B 2L7, Canada , you would configure the following filter:

{
  "attribute": "company_location",
  "relation": "within",
  "value": {
    "address": "Toronto, M5B 2L7, Ontario",
    "radius": 2,
    "unit": "km"
  }
}

where address can be Toronto, Ontario, M5B 2L7, Canada or M5B 2L7, Toronto, Ontario or M5B 2L7, Toronto and other variations.


Strictness level

📘

Note

By default, the Company proximity filter searches only the company's main location ( default strictness: 1 )

You can extend your search to include a company's secondary locations by providing a strictness parameter:

  • strictness: 1 - searches only within the main location of the company.
  • strictness: 2 - searches only within the secondary locations of the company.
  • strictness: 3 - includes both the main location and secondary locations of the company.

For example, the following filter returns all companies that have a secondary location in a 2 km radius from M5B 2L7, Toronto:

{
  "attribute": "company_location",
  "relation": "within",
  "value": {
    "address": "M5B 2L7, Toronto",
    "radius": 2,
    "unit": "km"
  },
  "strictness": 2
}

Alternatively, this filter returns all companies that have any location (either main or secondary) in a 2 km radius from M5B 2L7, Toronto:

{
  "attribute": "company_location",
  "relation": "within",
  "value": {
    "address": "M5B 2L7, Toronto",
    "radius": 2,
    "unit": "km"
  },
  "strictness": 3
}