> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waterfall.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prospector location filter

> How location_country, location_countries, and location_name work.

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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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"    |

<Tip>
  Region-level filtering (state or province) gives the best balance of precision and coverage. City-level can reduce results significantly.
</Tip>

## Combining filters

`location_name` and `location_countries` can be used together. For example, to find contacts in California or anywhere in France:

```json theme={null}
{
  "domain": "acme.com",
  "title_filter": "head of sales OR vp sales",
  "location_name": "California",
  "location_countries": ["France"]
}
```