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
The search retrieves companies located within a predefined radius of the specified geographical location. To ensure comprehensive coverage, results may include companies with varying levels of location precision:

When a company’s address includes street and street number, its coordinates allow for highly specific distance-based matching.

However, when only broader information such as city or postcode is available, the company’s location is approximated using the geographic center of that area. These approximate matches are included in the results to avoid excluding relevant suppliers and to provide a more complete view of potential options within the search radius.

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 number. 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 )

📘
Note
You can specify small distances using decimal values for the radius value (e.g., 0.05 km for 50 meters).

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
This filter supports searching for both main and secondary locations of a company.
By default, the Company proximity filter searches only the company's main location ( default strictness: 1 )

📖
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.

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
}