How do I filter leads by postcode, city, or street?

WS
WarmySender Team
Updated Sep 5, 2026

Short answer: open the Leads page and use the location filters in order — Country, then State / Region, then City, then Postcode / ZIP, and finally Street contains (under More filters) if you want a single street or building. City is forgiving: type it in any capitalization and it still matches, and common short forms work too, so NYC finds New York. Postcode / ZIP matches from the start of the code, so typing 100 returns every 100xx ZIP and M5V returns that part of downtown Toronto. Postcode and Street are available for United States and Canada contacts today. There is no deliverability filter here — when your list is saved, run it through the Email Verifier before you launch.

WarmySender runs your outreach on autopilot with AI agents, across Cold Email, Email Warmup, LinkedIn, Instagram and Multichannel sequences — plus real-time email verification. The lead database is the prospecting input that feeds all of them, so the tighter your location filter, the more relevant every campaign that follows.

The location filters, from widest to narrowest

Filter What it narrows to Where you'll find it
Country A whole market Location
State / Region A state, province or region inside that country Location
City One or several cities — typed any way you like Location
Postcode / ZIP Everything starting with the code you type (US and Canada) Location
Street contains A street or building name inside the address (US and Canada) More filters

Every filter is additive — each one you add makes the list smaller and more precise, and a live match count updates as you go. Work top to bottom, and stop as soon as the count is the size you want.

City — type it however you like, and add as many as you want

The City filter no longer cares how you type a name. new york, New York and NEW YORK all return the same contacts, so a lower-case list pasted from a spreadsheet works exactly as well as a carefully capitalized one.

It also understands the short forms and nicknames people actually use. Type NYC and you get New York. The same goes for the other common abbreviations, so you don't have to guess whether the records were saved with the full name or the short one — either gets you there.

You can add several cities at once. Adding Boston, Chicago and Denver returns contacts in any of the three, which is the quickest way to build a multi-market list without running three separate searches and stitching them together afterwards.

A note worth knowing: city names repeat across the world (there is a Paris in France and a Paris in Texas). Pair City with Country — and with State / Region where it helps — so you get the one you meant.

Postcode / ZIP — matches from the start of the code

The Postcode / ZIP filter is the fastest way to go local, and the important thing to understand is that it matches from the beginning of the code, not the whole thing. That means you choose how wide the net is by how much you type:

So a shorter code is a wider area and a longer code is a tighter one. Start short, watch the live match count, and add a digit or a letter when you want to zoom in further.

Two honest caveats. First, Postcode / ZIP is available for United States and Canada contacts. Second, not every contact carries a postcode — plenty of records have a city and a state but no code on file. Filtering by postcode alone will therefore always show you fewer people than exist in that area. The fix is simple: combine it with City or State / Region so you keep the contacts that are clearly in your area but happen to have no code, and use the postcode to add precision rather than as your only location filter.

Street contains — for a single street, building or business park

Under More filters you'll find Street contains. It looks for the words you type anywhere inside a contact's street address, so it's the right tool when your target is a specific place rather than a region:

Keep the words short and distinctive. Yonge works better than Yonge Street Suite 400, because the shorter phrase matches more of the ways an address can be written. Street contains covers United States and Canada contacts, and like the postcode it's best used on top of a City or State / Region filter rather than on its own.

Checking deliverability before you send

There is no deliverability filter on the lead database, and we'd rather say so plainly than offer one we can't stand behind. The database is a directory of contact details; it does not tell you whether a particular mailbox will accept mail today, and an address that was reachable when the record was collected may not be reachable now.

The honest sequence is: build your list with the filters above, Save to List, and then run that saved list through the Email Verifier — the same check WarmySender runs on a list you upload yourself. It checks each address at that moment, which is the only way to know. For how to read each result, see what email verification results mean.

"Did you mean …?" suggestions

Typos are the quiet reason a search comes back nearly empty. When a keyword looks misspelled, or a search returns very few matches, WarmySender now offers a "Did you mean …?" suggestion right above the results. Click it and the search re-runs with the corrected wording.

It's worth glancing at whenever a count looks surprisingly low — a single transposed letter is far more often the cause than a genuinely empty market.

Worked examples

Lawyers in New York, Manhattan only

  1. Country: United States.
  2. City: type NYC — the short form is understood and resolves to New York. (Typing new york in lower case works just as well.)
  3. Postcode / ZIP: type 100. That keeps every ZIP starting with 100, which is the Manhattan block of codes.
  4. Job title: Lawyer (add Attorney as a second search if you want both wordings).

The live count now shows lawyers at Manhattan addresses. Want the whole city back? Clear the postcode and the City filter alone returns all five boroughs. Want an even tighter list? Extend the code to 10012.

Dentists in downtown Toronto

  1. Country: Canada.
  2. City: Toronto.
  3. Postcode / ZIP: M5V — the downtown core.
  4. Job title: Dentist.

Because some Toronto records have a city but no postal code, keep the City filter switched on alongside the code. If the count is smaller than you expected, drop the postal code and search the whole city — then add the code back once you've seen how much it costs you.

A clean list, ready to send today

  1. Build your list with any combination above — say City = Boston and Chicago, Seniority = VP.
  2. Select the contacts and choose Save to List.
  3. Run that saved list through the Email Verifier, then launch a campaign from it once the results are back.

Saved leads land in the same prospect list a CSV import would create, so sequences, sending limits, warmup and analytics all behave exactly the same downstream.

What these filters can't do yet

We'd rather tell you the gaps than let you discover them mid-search:

Using these filters with an AI agent

Everything on this page is also available to an AI agent connected to your account — Claude, ChatGPT, Cursor, Codex, OpenClaw, Hermes Agent, or any agent that speaks MCP. The lead search offers the same options under the same names: postalCode and address (the street match), alongside city, state and country. There is no deliverability option, for the same reason there's no switch on the page.

In practice you just ask in plain language — "find me dentists in Toronto with a postal code starting M5V and save them to a new list" — and the agent builds the search and the list for you, and can verify the saved list for you too. Your agent never sends a message on its own and can never raise a limit: WarmySender's scheduler paces every email, LinkedIn and Instagram action inside safe caps no matter who's driving. See how to connect your AI agent.

Frequently asked questions

Does the Postcode / ZIP filter need the full code?

No. It matches from the start of the code, so you choose how wide the area is by how much you type. Typing 100 returns every ZIP that begins with 100 (10001, 10012, 10023 and so on), while typing 10001 returns just that one. Canadian postal codes work the same way — M5V returns that part of downtown Toronto — and capitalization doesn't matter. A shorter code is a wider area, a longer code is a tighter one.

Which countries have postcode and street data?

Postcode / ZIP and Street contains are available for United States and Canada contacts today. There is no postcode data for the United Kingdom or Australia yet, so in those markets use City and State / Region instead — both are well covered. Bear in mind that even in the US and Canada not every contact carries a postcode or a street, so combine those filters with City or State / Region rather than using them on their own.

Do I have to capitalize city names correctly?

No. City matches however you type it, so new york, New York and NEW YORK all return the same contacts. It also understands the common short forms and nicknames — type NYC and you get New York. You can add several cities at once too, so Boston, Chicago and Denver together return contacts in any of the three.

Can I search within a radius of an address?

Not yet — there is no "within X miles" search. The closest equivalent is the Postcode / ZIP filter, which matches from the start of the code: type a shorter code for a wider area and a longer one to zoom in. For example 100 covers a large part of Manhattan while 10001 is a single ZIP. If radius search matters to you, email [email protected] so we can prioritize it.

What does "Street contains" match?

It looks for the words you type anywhere inside a contact's street address, which makes it right for a named office tower, a business park, or a single avenue you're canvassing — type Yonge and you get the addresses on Yonge Street. Keep the words short and distinctive, because a short phrase matches more of the ways an address can be written. It covers United States and Canada contacts and works best layered on top of a City or State / Region filter.

My search returned almost nothing. What should I check?

Check three things in order. First, look for a "Did you mean …?" suggestion above the results — a single mistyped letter is the most common cause of a nearly-empty list, and clicking the suggestion re-runs the search corrected. Second, if you filtered by postcode or street, remember not every contact carries one: add City or State / Region so you keep the people who are clearly in your area but have less address detail on file. Third, drop your narrowest filter — usually the postcode or the street term — and add it back once you've seen what it costs you.

Can an AI agent use these filters?

Yes. An agent connected to your account — Claude, ChatGPT, Cursor, Codex, OpenClaw, Hermes Agent, or any agent that speaks MCP — can search leads with the same options under the same names: postalCode and address for the street match, alongside city, state and country. You ask in plain language and the agent builds the search and saves the list, and it can run that list through the Email Verifier for you before you launch. Your agent never sends a message itself and can never raise a limit — WarmySender's scheduler paces every action inside safe caps regardless of who started it.

Still have questions? Email [email protected] — we respond within 24 hours on business days.