# Filter your leads from your code (/docs/leads/website-visitors/filters/api)

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["GET /v3/leads", "GET /admin/location/countries", "GET /admin/location/states", "GET /admin/location/cities"]} />

<ApiPlayground
  ops={["GET /v3/leads", "GET /admin/location/countries", "GET /admin/location/states", "GET /admin/location/cities"]}
  method="get"
  path="/v3/leads"
  tool="get_leads"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "dateFrom": "2026-10-01",
  "dateTo": "2026-10-30",
  "visitorLocation": "Germany",
  "employeesMin": 50,
  "exactVisitor": true
}`}
/>

## Use case: Decision makers from Germany [#use-case-decision-makers-from-germany]

`visitorLocation=Germany`, `employeesMin=50` and `exactVisitor=true` over the month: people at mid-size German companies, not just their company.

## Use case: Who came from your Google Ads [#use-case-who-came-from-your-google-ads]

`utmSource=google` (and `utmMedium=cpc`) with the period you want.

## Use case: Who looked at pricing [#use-case-who-looked-at-pricing]

`pageVisited=/pricing`. Combine with `visits_lower_bound=2` for people who came back.