Prospector supports three location parameters. They can be used individually or combined.
location_country
Exact country match. Use full country names — partial values are not valid.
{
"domain": "acme.com",
"title_filter": "head of sales OR vp sales",
"location_country": "United States"
}
location_countries
Use when you need to target multiple countries. Overrides location_country when present and non-empty.
{
"domain": "acme.com",
"title_filter": "head of sales OR vp sales",
"location_countries": ["United States", "Canada", "United Kingdom"]
}
location_name
Free-text location string. Accepts full or partial values — city, region, or country. Waterfall matches contacts whose location contains the string.
{
"domain": "acme.com",
"title_filter": "head of sales OR vp sales",
"location_name": "California, United States"
}
| Input | Matches |
|---|
San Francisco, California, United States | City-level — San Francisco only |
California, United States | State-level — all of California |
United States | Country-level — same as location_country |
Paris | Matches any location containing “Paris” |
Region-level filtering (state or province) gives the best balance of precision and coverage. City-level can reduce results significantly.
Combining filters
location_name and location_countries can be used together. For example, to find contacts in California or anywhere in France:
{
"domain": "acme.com",
"title_filter": "head of sales OR vp sales",
"location_name": "California",
"location_countries": ["France"]
}
