Skip to main content

​
Title filters

Two syntaxes are supported — pick one per request. title_filters — boolean expression per named group. Supports OR, AND, NOT: 
{
  "domain": "acme.com",
  "title_filters": [
    { "name": "sales_leaders", "filter": "head of sales OR vp sales OR director of sales" }
  ]
}
title_lists — explicit list of titles per named group. Useful when you have a curated set of exact titles: 
{
  "domain": "acme.com",
  "title_lists": [
    { "name": "sales_leaders", "titles": ["Head of Sales", "VP of Sales", "Director of Sales"] }
  ]
}
Up to 5 groups per request. Multiple groups act as OR — a contact matching any group is included.

​
Departments and seniorities

Optional filters that narrow results within any search mode. departments accepts strings like Sales, Marketing, Engineering, Finance, Operations. seniorities accepts strings like Manager, Director, VP, C-Level, Individual Contributor. 
{
  "domain": "acme.com",
  "departments": ["Sales"],
  "seniorities": ["Director", "VP"]
}

​
Location (contact-level)

location_countries filters contacts by where they are located — not where the company is headquartered. 
{
  "domain": "acme.com",
  "title_filters": [
    { "name": "sales_leaders", "filter": "head of sales OR vp sales" }
  ],
  "location_countries": ["United States", "Canada"]
}
For company-set searches, use company_location_countries to filter by company HQ country and location_countries to filter by the contact’s own location.

​
Name filters

FieldBehavior
included_namesRestrict results to contacts whose full name matches one of the listed strings
excluded_namesRemove contacts whose full name matches one of the listed strings
Useful when you want to target or skip specific individuals in a company search.