Prospector location filter

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"
}

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"]
}

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"
}

Valid partial forms:

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.

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"]
}