SalesNav Structured Filters

The POST /api/salesnav/search endpoint supports 28 structured filter types for precise lead search, matching the full SalesNav UI filter panel. The catalogue below is authoritative — the SalesNavFilterType union in src/services/salesnav-api.ts is the source of truth.

Quick Example

1
POST /api/salesnav/search
2
{
3
  "filters": [
4
    { "type": "SCHOOL", "values": [{ "text": "University of Cambridge" }] },
5
    { "type": "REGION", "values": [{ "text": "London" }] },
6
    { "type": "SENIORITY_LEVEL", "values": [{ "id": "8", "text": "CXO" }] }
7
  ],
8
  "maxResults": 25
9
}

Filter values can be names (auto-resolved via typeahead) or numeric IDs (faster, more reliable).

Filter Types

Company Filters

Role Filters

Personal Filters

Relationship Filters

Toggle Filters (boolean — no values needed)

Toggle filters are passed with an empty values array:

1
{ "type": "RECENTLY_CHANGED_JOBS", "values": [] }

Filter Logic

• Multiple values in ONE filter = OR: PAST_COMPANY with Barclays + HSBC → worked at either
• Multiple filter TYPES = AND: SCHOOL + REGION → went to school AND lives in region
• Exclusion: "selectionType": "EXCLUDED" → NOT this value

Typeahead Resolution

Resolve names to IDs before searching:

$
GET /api/salesnav/typeahead?type=SCHOOL&query=Cambridge
$
→ [{ "id": "4522", "text": "University of Cambridge" }, ...]

Supported typeahead types: SCHOOL, COMPANY_WITH_LIST, INDUSTRY, TITLE, BING_GEO, FUNCTION, GROUP, CONNECTION_OF.

Performance Tips

• 2-3 filters is the sweet spot — best result quality
• 4+ filters starts to narrow significantly
• Use numeric IDs when possible — skips typeahead round-trip
• Avoid mixing keywords + filters — keywords dilute filter precision
• Toggle filters combine freely — 2+ toggles work together

Common Patterns

See Query Patterns for tested examples including:

• Career trajectory analysis (ex-bankers at startups)
• Competitive intelligence (who left X for Y)
• Diaspora mapping (Greek/Indian/Nigerian tech workers abroad)
• Alumni at target companies
• Buying signals (viewed profile + changed jobs)