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 abbreviatedTX, 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.
- Partial address:
- 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
: Eitherkm
( kilometers ) ormi
( 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
}