Skip to Content
Filters Documentation

Search Filters Documentation

Complete reference for all filters available in the /search-person and /search-company endpoints.

This page documents every filter, its type, constraints, and provides examples for each.


Enum Values

Many filters require values from predefined lists. Here are all available enum references:

EnumDescriptionLink
DepartmentsPerson departmentsView all Departments
SenioritiesPerson seniority levelsView all Seniorities
IndustriesCompany industries (256 values)View all Industries
Employee rangesCompany size rangesView all Employee ranges
Funding stagesCompany funding stagesView all Funding stages
TechnologiesCompany tech stack (4,946 values)View all Technologies
NAICS codesIndustry classification codesView all NAICS codes
SIC codesStandard industrial codesView all SIC codes
MX providersEmail providers (107 values)View all MX providers

Quick Reference

Person Filters

Available only for /search-person:

FilterTypeDescriptionEnum Values
person_nameIncludeExcludeFilter by person’s name
person_name_or_job_titlestringQuick search across name and job title
person_job_titleJobTitleFilterFilter by job title with boolean search supportUse Search Suggestions API
person_departmentIncludeExcludeFilter by departmentDepartments
person_seniorityIncludeExcludeFilter by seniority levelSeniorities
person_location_searchIncludeExcludeFilter by person’s locationUse Search Suggestions API
person_contact_detailsContactDetailsFilterFilter by email/mobile availability
person_duplicate_controlDuplicateControlFilterControl duplicate records
max_person_per_companyintegerLimit results per company
person_year_of_experienceRangeFilter by years of experience
person_time_in_current_roleRangeFilter by months in current role
person_time_in_current_companyRangeFilter by months at current company
person_job_changeJobChangeFilterFilter by recent job changes

Company Filters

Available for both /search-person and /search-company:

FilterTypeDescriptionEnum Values
companyCompanyFilterFilter by company name or website
company_location_searchIncludeExcludeFilter by company HQ locationUse Search Suggestions API
company_headcount_rangearrayFilter by predefined employee rangesEmployee ranges
company_headcount_customRangeCustom employee count range
company_industryIncludeExcludeFilter by industryIndustries
company_keywordsKeywordsFilterFilter by company keywords
company_attributesAttributesFilterFilter by company attributes
company_naicsIncludeExcludeFilter by NAICS codesNAICS codes
company_sicsIncludeExcludeFilter by SIC codesSIC codes
company_revenueRevenueFilterFilter by revenue range
company_typestringFilter by company type
company_fundingFundingFilterFilter by funding detailsFunding stages
company_technologyIncludeExcludeFilter by technologies usedTechnologies
company_foundedFoundedFilterFilter by founding year
company_headcount_growthHeadcountGrowthFilterFilter by headcount growth %Departments
company_job_posting_hiring_forarrayFilter by job posting titles
company_job_posting_quantityRangeFilter by number of job postings
company_headcount_by_departmentarrayFilter by department headcountDepartments
company_email_providerarrayFilter by email providerMX providers

Global Constraints

ConstraintValue
Max total filter values across all filters20,000
Max include/exclude items per filter500 (unless otherwise specified)
Max page number1,000
Results per page25 (fixed)

It is not allowed to perform a search solely with exclude filters for performance reasons. You must have at least one positive filter.


Person Filters

person_name

Filter by person’s first name, last name, or full name.

FieldTypeConstraints
includearray of stringsMax 500 items. Each name: 1-100 characters
excludearray of stringsMax 500 items. Each name: 1-100 characters
{ "person_name": { "include": ["John Smith", "Jane Doe"], "exclude": ["Bob Wilson"] } }

person_name_or_job_title

Quick search filter that matches across both person name and job title fields. Useful for simple searches.

TypeConstraints
stringFree text search term
{ "person_name_or_job_title": "Kevin" }

person_job_title

Filter by job title with support for exact match, contains match, or advanced boolean search expressions.

FieldTypeConstraints
includearray of stringsMax 100 items. Each title: 2-100 characters
excludearray of stringsMax 100 items. Each title: 2-100 characters
match_only_exact_job_titlesbooleanDefault: true. When false, uses contains matching
boolean_searchstringMax 500 terms, max 5 parenthesis depth, each term 3-100 chars

boolean_search cannot be combined with include/exclude. Use one or the other.

{ "person_job_title": { "include": ["CEO", "Chief Executive Officer"], "exclude": ["Intern"], "match_only_exact_job_titles": true } }

Boolean Search Syntax

SyntaxMeaningExample
termContains matchingmanager matches “Project Manager”, “Manager”
"term"Exact matching (double quotes)"Manager" matches only “Manager” exactly
'term'Contains with spaces (single quotes)'vice president' matches titles containing “vice president”
!termExclude!intern excludes titles containing “intern”
ANDBoth conditions must matchCEO AND founder
OREither condition matchesCEO OR CTO
()Grouping(engineer OR developer) AND senior

You cannot mix AND/OR at the same level without parentheses. Use parentheses to group conditions.


person_department

Filter by the person’s functional department. See Departments for all valid values.

FieldTypeConstraints
includearray of stringsMax 500 items. Must be valid Department value
excludearray of stringsMax 500 items. Must be valid Department value
{ "person_department": { "include": ["Sales", "Marketing"], "exclude": ["Human Resources"] } }

person_seniority

Filter by the person’s seniority level. See Seniorities for all valid values.

FieldTypeConstraints
includearray of stringsMax 11 items. Must be valid Seniority value
excludearray of stringsMax 11 items. Must be valid Seniority value
{ "person_seniority": { "include": ["C-Suite", "Vice President", "Director"], "exclude": ["Intern", "Entry"] } }

Filter by the person’s location.

FieldTypeConstraints
includearray of stringsMax 100 items. Each: 1-200 characters. Must be valid location
excludearray of stringsMax 100 items. Each: 1-200 characters. Must be valid location

Location values must be obtained from the Search Suggestions API with location_search parameter. Invalid locations will be rejected.

{ "person_location_search": { "include": ["United States", "New York, United States"], "exclude": ["Texas, United States"] } }

person_contact_details

Filter by availability of verified email or mobile.

FieldTypeValid ValuesDescription
emailarray of strings["VERIFIED"]Filter for verified emails
mobilearray of strings["VERIFIED", "UNAVAILABLE"]Filter for mobile status
operatorstring"OR", "AND"Combine email/mobile conditions. Default: "OR"
hide_people_with_details_already_revealedbooleantrue, falseHide already revealed contacts
{ "person_contact_details": { "email": ["VERIFIED"], "mobile": ["VERIFIED"], "operator": "OR", "hide_people_with_details_already_revealed": false } }

person_duplicate_control

Control duplicate handling for search results. This filter allows you to hide people based on your existing lists and export history.

For detailed configuration options and list IDs, use the dashboard UI to build your duplicate control settings and export the JSON payload.


max_person_per_company

Limit the number of people returned per company.

TypeConstraints
integer1-100
{ "max_person_per_company": 5 }

person_year_of_experience

Filter by total years of professional experience.

FieldTypeConstraints
mininteger0-60 years
maxinteger0-60 years. Must be ≥ min
{ "person_year_of_experience": { "min": 5, "max": 15 } }

person_time_in_current_role

Filter by months in current job role.

FieldTypeConstraints
mininteger0-600 months
maxinteger0-600 months. Must be ≥ min
{ "person_time_in_current_role": { "min": 6, "max": 24 } }

person_time_in_current_company

Filter by months at current company.

FieldTypeConstraints
mininteger0-600 months
maxinteger0-600 months. Must be ≥ min
{ "person_time_in_current_company": { "min": 12, "max": 60 } }

person_job_change

Filter by recent job changes.

FieldTypeValid ValuesDescription
timeframe_daysinteger30, 60, 90, 180, 270, 365Days since job change
only_promotionbooleantrue, falseFilter for promotions only
only_new_companybooleantrue, falseFilter for company changes only

only_promotion and only_new_company cannot both be true.

{ "person_job_change": { "timeframe_days": 90, "only_promotion": false, "only_new_company": true } }

Company Filters

company

Filter by company name or website.

FieldTypeConstraints
names.includearray of stringsTotal names + websites ≤ 500
names.excludearray of stringsMax 500 items
websites.includearray of stringsValid domain format, no subdomains
websites.excludearray of stringsMax 500 items

Website values should be root domains only (e.g., google.com, not www.google.com or mail.google.com).

{ "company": { "names": { "include": ["Google", "Microsoft"], "exclude": ["Amazon"] }, "websites": { "include": ["google.com", "microsoft.com"], "exclude": [] } } }

Filter by company headquarters location.

FieldTypeConstraints
includearray of stringsMax 100 items. Must be valid location from Search Suggestions API
excludearray of stringsMax 100 items. Must be valid location from Search Suggestions API
{ "company_location_search": { "include": ["United States", "San Francisco, California, United States"], "exclude": ["China"] } }

company_headcount_range

Filter by predefined employee count ranges. See Employee ranges for all valid values.

TypeValid Values
array of strings1-10, 11-20, 21-50, 51-100, 101-200, 201-500, 501-1000, 1001-2000, 2001-5000, 5001-10000, 10000+. See Employee ranges

Cannot be used together with company_headcount_custom.

{ "company_headcount_range": ["51-100", "101-200", "201-500"] }

company_headcount_custom

Filter by custom employee count range.

FieldTypeConstraints
mininteger1-999,998
maxinteger1-999,999. Must be ≥ min

Cannot be used together with company_headcount_range.

{ "company_headcount_custom": { "min": 100, "max": 5000 } }

company_industry

Filter by company industry. See Industries for all 256 valid values.

FieldTypeConstraints
includearray of stringsMax 500 items. Must be valid Industry value
excludearray of stringsMax 500 items. Must be valid Industry value
{ "company_industry": { "include": ["Software Development", "IT Services and IT Consulting"], "exclude": ["Construction"] } }

company_keywords

Filter by keywords found in company data.

FieldTypeConstraints
includearray of stringsTotal include + exclude ≤ 20. Each: 3-50 characters
excludearray of stringsTotal include + exclude ≤ 20. Each: 3-50 characters
include_allbooleanIf true, ALL include keywords must match (AND logic)
include_company_descriptionbooleanSearch in company description
include_company_description_seobooleanSearch in SEO description

At least one keyword must be provided (either include or exclude).

{ "company_keywords": { "include": ["saas", "b2b", "enterprise"], "exclude": ["consumer"], "include_all": false, "include_company_description": true, "include_company_description_seo": true } }

company_attributes

Filter by company attributes (boolean flags).

FieldTypeDescription
b2bboolean or nullCompany is B2B
demoboolean or nullOffers demo
freetrialboolean or nullOffers free trial
downloadableboolean or nullHas downloadable product
mobileappsboolean or nullHas mobile apps
onlinereviewsboolean or nullHas online reviews
pricingboolean or nullShows pricing on website
{ "company_attributes": { "b2b": true, "demo": true, "freetrial": false, "downloadable": null, "mobileapps": null, "onlinereviews": null, "pricing": true } }

company_naics

Filter by NAICS (North American Industry Classification System) codes. See NAICS codes for valid values.

FieldTypeConstraints
includearray of integersMax 100 items. Each code: 1-999,999
excludearray of integersMax 100 items. Each code: 1-999,999
{ "company_naics": { "include": [541511, 541512], "exclude": [236220] } }

company_sics

Filter by SIC (Standard Industrial Classification) codes. See SIC codes for valid values.

FieldTypeConstraints
includearray of integersMax 100 items. Each code: 1-999,999
excludearray of integersMax 100 items. Each code: 1-999,999
{ "company_sics": { "include": [7371, 7372], "exclude": [1521] } }

company_revenue

Filter by company revenue range.

FieldTypeConstraints
minstringMust be valid Revenue Range value
maxstringMust be valid Revenue Range value. Must be ≥ min
include_unknown_revenuebooleanInclude companies with unknown revenue
{ "company_revenue": { "min": "10M", "max": "500M", "include_unknown_revenue": false } }

company_type

Filter by company type.

TypeValid Values
string"Private", "Public", "Non Profit", "Other"
{ "company_type": "Private" }

company_funding

Filter by funding information. See Funding stages for valid stage values.

FieldTypeConstraints
stagearray of stringsMax 500 items. Must be valid Funding Stage values
funding_dateintegerDays since last funding: 30, 60, 90, 180, 270, 365
last_funding.minstringMust be valid Revenue Range value
last_funding.maxstringMust be valid Revenue Range value. Must be ≥ min
total_funding.minstringMust be valid Revenue Range value
total_funding.maxstringMust be valid Revenue Range value. Must be ≥ min
{ "company_funding": { "stage": ["Series A", "Series B", "Series C"], "funding_date": 365, "last_funding": { "min": "1M", "max": "100M" }, "total_funding": { "min": "5M", "max": "500M" } } }

company_technology

Filter by technologies used by the company. See Technologies for all 4,946 valid values.

FieldTypeConstraints
includearray of stringsMax 20 items. Must be valid Technology value
excludearray of stringsMax 20 items. Must be valid Technology value
{ "company_technology": { "include": ["Salesforce", "HubSpot", "AWS"], "exclude": ["Azure"] } }

company_founded

Filter by company founding year.

FieldTypeConstraints
mininteger1900 - current year
maxinteger1900 - current year. Must be ≥ min
include_unknown_foundedbooleanInclude companies with unknown founding year. Default: true
{ "company_founded": { "min": 2010, "max": 2020, "include_unknown_founded": true } }

company_headcount_growth

Filter by headcount growth percentage over a time period.

FieldTypeConstraints
timeframe_monthinteger3, 6, 12, or 24
mininteger-100 to 10,000 (percentage)
maxinteger-100 to 10,000 (percentage). Must be ≥ min
departmentsarray of stringsMax 10 items. Must be valid Headcount Growth Department values
{ "company_headcount_growth": { "timeframe_month": 12, "min": 10, "max": 100, "departments": ["Sales", "Technical"] } }

company_job_posting_hiring_for

Filter by job titles the company is actively hiring for.

TypeConstraints
array of stringsMax 500 items. Each title: 1-200 characters
{ "company_job_posting_hiring_for": ["Software Engineer", "Sales Manager", "Product Manager"] }

company_job_posting_quantity

Filter by number of active job postings.

FieldTypeConstraints
mininteger0-5,000
maxinteger0-5,000
{ "company_job_posting_quantity": { "min": 10, "max": 100 } }

company_headcount_by_department

Filter by headcount in specific departments. Max 10 department filters in the array. See Departments for valid department values.

FieldTypeConstraints
departmentstringMust be valid Department value
mininteger0-100,000
maxinteger0-100,000
{ "company_headcount_by_department": [ { "department": "Sales", "min": 10, "max": 100 }, { "department": "Engineering & Technical", "min": 50, "max": null } ] }

company_email_provider

Filter by the company’s email provider. See MX providers for all 107 valid values.

TypeConstraints
array of stringsMust be valid Email Provider values
{ "company_email_provider": ["Google", "Microsoft"] }

Enum Values Reference

Below are quick references for common enum values. For complete and up-to-date lists, always refer to the dedicated enum pages.

Seniority Values

View all Seniorities

C-Suite Director Entry Founder/Owner Head Intern Manager Partner Senior Vice President

Employee Range Values

View all Employee ranges

1-10 11-20 21-50 51-100 101-200 201-500 501-1000 1001-2000 2001-5000 5001-10000 10000+

Revenue Range Values

Listed from lowest to highest:

<100K 100K 500K 1M 5M 10M 25M 50M 100M 250M 500M 1B 5B 10B+

Company Type Values

Private Public Non Profit Other

Funding Stage Values

View all Funding stages

Angel Convertible note Corporate round Debt financing Equity crowdfunding Grant Initial coin offering Non equity assistance Post IPO debt Post IPO equity Post IPO secondary Pre seed Private equity Product crowdfunding Secondary market Seed Series A Series B Series C Series D Series E-J Series unknown Undisclosed

Department Values

View all Departments

Top-Level Departments:

C-Suite Consulting Design Education & Coaching Engineering & Technical Finance Human Resources Information Technology Legal Marketing Medical & Health Operations Product Sales

Headcount Growth Department Values

View Headcount Growth Departments

Used specifically for company_headcount_growth.departments:

Administrative Consulting Customer service Design / UI / UX Education Finance General management HR Legal Marketing Medical Operations Product Project management Real estate Research Sales Technical Trades

Other Enum Values

The following enums have extensive lists. Please refer to their dedicated pages:

EnumCountLink
Industries256 valuesView all Industries
Technologies4,946 valuesView all Technologies
NAICS codesExtensive listView all NAICS codes
SIC codesExtensive listView all SIC codes
MX providers107 valuesView all MX providers

Forbidden Filters

The following filters are blocked for the public API and will return an error if used:

FilterBlocked For
company_intentBoth /search-person and /search-company
company.company_oids/search-company
company.temp_matching_oids/search-company
company.company_list_oids/search-company

Complete Example Requests

Search People by Job Title, Seniority, and Company

{ "filters": { "person_job_title": { "include": ["CEO", "CTO", "VP Engineering"], "match_only_exact_job_titles": false }, "person_seniority": { "include": ["C-Suite", "Vice President"] }, "company": { "names": { "include": ["Microsoft", "Google", "Apple"] } }, "person_location_search": { "include": ["United States"] } }, "page": 1 }
{ "filters": { "person_job_title": { "boolean_search": "(CEO OR CTO OR \"Chief Technology Officer\") AND !Intern" }, "company_industry": { "include": ["Software Development", "IT Services and IT Consulting"] }, "company_headcount_range": ["101-200", "201-500", "501-1000"] }, "page": 1 }

Search Companies by Industry, Size, and Funding

{ "filters": { "company_industry": { "include": ["Software Development", "IT Services and IT Consulting"] }, "company_headcount_range": ["101-200", "201-500", "501-1000"], "company_funding": { "stage": ["Series A", "Series B", "Series C"], "funding_date": 365 }, "company_location_search": { "include": ["United States"] }, "company_revenue": { "min": "10M", "max": "500M" } }, "page": 1 }

Search Companies by Technology and Growth

{ "filters": { "company_technology": { "include": ["Salesforce", "HubSpot"] }, "company_headcount_growth": { "timeframe_month": 12, "min": 20, "max": 200 }, "company_job_posting_quantity": { "min": 10 } }, "page": 1 }
Last updated on