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:
| Enum | Description | Link |
|---|---|---|
| Departments | Person departments | View all Departments |
| Seniorities | Person seniority levels | View all Seniorities |
| Industries | Company industries (256 values) | View all Industries |
| Employee ranges | Company size ranges | View all Employee ranges |
| Funding stages | Company funding stages | View all Funding stages |
| Technologies | Company tech stack (4,946 values) | View all Technologies |
| NAICS codes | Industry classification codes | View all NAICS codes |
| SIC codes | Standard industrial codes | View all SIC codes |
| MX providers | Email providers (107 values) | View all MX providers |
Quick Reference
Person Filters
Available only for /search-person:
| Filter | Type | Description | Enum Values |
|---|---|---|---|
person_name | IncludeExclude | Filter by person’s name | — |
person_name_or_job_title | string | Quick search across name and job title | — |
person_job_title | JobTitleFilter | Filter by job title with boolean search support | Use Search Suggestions API |
person_department | IncludeExclude | Filter by department | Departments |
person_seniority | IncludeExclude | Filter by seniority level | Seniorities |
person_location_search | IncludeExclude | Filter by person’s location | Use Search Suggestions API |
person_contact_details | ContactDetailsFilter | Filter by email/mobile availability | — |
person_duplicate_control | DuplicateControlFilter | Control duplicate records | — |
max_person_per_company | integer | Limit results per company | — |
person_year_of_experience | Range | Filter by years of experience | — |
person_time_in_current_role | Range | Filter by months in current role | — |
person_time_in_current_company | Range | Filter by months at current company | — |
person_job_change | JobChangeFilter | Filter by recent job changes | — |
Company Filters
Available for both /search-person and /search-company:
| Filter | Type | Description | Enum Values |
|---|---|---|---|
company | CompanyFilter | Filter by company name or website | — |
company_location_search | IncludeExclude | Filter by company HQ location | Use Search Suggestions API |
company_headcount_range | array | Filter by predefined employee ranges | Employee ranges |
company_headcount_custom | Range | Custom employee count range | — |
company_industry | IncludeExclude | Filter by industry | Industries |
company_keywords | KeywordsFilter | Filter by company keywords | — |
company_attributes | AttributesFilter | Filter by company attributes | — |
company_naics | IncludeExclude | Filter by NAICS codes | NAICS codes |
company_sics | IncludeExclude | Filter by SIC codes | SIC codes |
company_revenue | RevenueFilter | Filter by revenue range | — |
company_type | string | Filter by company type | — |
company_funding | FundingFilter | Filter by funding details | Funding stages |
company_technology | IncludeExclude | Filter by technologies used | Technologies |
company_founded | FoundedFilter | Filter by founding year | — |
company_headcount_growth | HeadcountGrowthFilter | Filter by headcount growth % | Departments |
company_job_posting_hiring_for | array | Filter by job posting titles | — |
company_job_posting_quantity | Range | Filter by number of job postings | — |
company_headcount_by_department | array | Filter by department headcount | Departments |
company_email_provider | array | Filter by email provider | MX providers |
Global Constraints
| Constraint | Value |
|---|---|
| Max total filter values across all filters | 20,000 |
| Max include/exclude items per filter | 500 (unless otherwise specified) |
| Max page number | 1,000 |
| Results per page | 25 (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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 500 items. Each name: 1-100 characters |
exclude | array of strings | Max 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.
| Type | Constraints |
|---|---|
| string | Free 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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 100 items. Each title: 2-100 characters |
exclude | array of strings | Max 100 items. Each title: 2-100 characters |
match_only_exact_job_titles | boolean | Default: true. When false, uses contains matching |
boolean_search | string | Max 500 terms, max 5 parenthesis depth, each term 3-100 chars |
boolean_search cannot be combined with include/exclude. Use one or the other.
Standard Mode
{
"person_job_title": {
"include": ["CEO", "Chief Executive Officer"],
"exclude": ["Intern"],
"match_only_exact_job_titles": true
}
}Boolean Search Syntax
| Syntax | Meaning | Example |
|---|---|---|
term | Contains matching | manager 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” |
!term | Exclude | !intern excludes titles containing “intern” |
AND | Both conditions must match | CEO AND founder |
OR | Either condition matches | CEO 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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 500 items. Must be valid Department value |
exclude | array of strings | Max 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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 11 items. Must be valid Seniority value |
exclude | array of strings | Max 11 items. Must be valid Seniority value |
{
"person_seniority": {
"include": ["C-Suite", "Vice President", "Director"],
"exclude": ["Intern", "Entry"]
}
}person_location_search
Filter by the person’s location.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 100 items. Each: 1-200 characters. Must be valid location |
exclude | array of strings | Max 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.
| Field | Type | Valid Values | Description |
|---|---|---|---|
email | array of strings | ["VERIFIED"] | Filter for verified emails |
mobile | array of strings | ["VERIFIED", "UNAVAILABLE"] | Filter for mobile status |
operator | string | "OR", "AND" | Combine email/mobile conditions. Default: "OR" |
hide_people_with_details_already_revealed | boolean | true, false | Hide 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.
| Type | Constraints |
|---|---|
| integer | 1-100 |
{
"max_person_per_company": 5
}person_year_of_experience
Filter by total years of professional experience.
| Field | Type | Constraints |
|---|---|---|
min | integer | 0-60 years |
max | integer | 0-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.
| Field | Type | Constraints |
|---|---|---|
min | integer | 0-600 months |
max | integer | 0-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.
| Field | Type | Constraints |
|---|---|---|
min | integer | 0-600 months |
max | integer | 0-600 months. Must be ≥ min |
{
"person_time_in_current_company": {
"min": 12,
"max": 60
}
}person_job_change
Filter by recent job changes.
| Field | Type | Valid Values | Description |
|---|---|---|---|
timeframe_days | integer | 30, 60, 90, 180, 270, 365 | Days since job change |
only_promotion | boolean | true, false | Filter for promotions only |
only_new_company | boolean | true, false | Filter 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.
| Field | Type | Constraints |
|---|---|---|
names.include | array of strings | Total names + websites ≤ 500 |
names.exclude | array of strings | Max 500 items |
websites.include | array of strings | Valid domain format, no subdomains |
websites.exclude | array of strings | Max 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": []
}
}
}company_location_search
Filter by company headquarters location.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 100 items. Must be valid location from Search Suggestions API |
exclude | array of strings | Max 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.
| Type | Valid Values |
|---|---|
| array of strings | 1-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.
| Field | Type | Constraints |
|---|---|---|
min | integer | 1-999,998 |
max | integer | 1-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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 500 items. Must be valid Industry value |
exclude | array of strings | Max 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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Total include + exclude ≤ 20. Each: 3-50 characters |
exclude | array of strings | Total include + exclude ≤ 20. Each: 3-50 characters |
include_all | boolean | If true, ALL include keywords must match (AND logic) |
include_company_description | boolean | Search in company description |
include_company_description_seo | boolean | Search 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).
| Field | Type | Description |
|---|---|---|
b2b | boolean or null | Company is B2B |
demo | boolean or null | Offers demo |
freetrial | boolean or null | Offers free trial |
downloadable | boolean or null | Has downloadable product |
mobileapps | boolean or null | Has mobile apps |
onlinereviews | boolean or null | Has online reviews |
pricing | boolean or null | Shows 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.
| Field | Type | Constraints |
|---|---|---|
include | array of integers | Max 100 items. Each code: 1-999,999 |
exclude | array of integers | Max 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.
| Field | Type | Constraints |
|---|---|---|
include | array of integers | Max 100 items. Each code: 1-999,999 |
exclude | array of integers | Max 100 items. Each code: 1-999,999 |
{
"company_sics": {
"include": [7371, 7372],
"exclude": [1521]
}
}company_revenue
Filter by company revenue range.
| Field | Type | Constraints |
|---|---|---|
min | string | Must be valid Revenue Range value |
max | string | Must be valid Revenue Range value. Must be ≥ min |
include_unknown_revenue | boolean | Include companies with unknown revenue |
{
"company_revenue": {
"min": "10M",
"max": "500M",
"include_unknown_revenue": false
}
}company_type
Filter by company type.
| Type | Valid Values |
|---|---|
| string | "Private", "Public", "Non Profit", "Other" |
{
"company_type": "Private"
}company_funding
Filter by funding information. See Funding stages for valid stage values.
| Field | Type | Constraints |
|---|---|---|
stage | array of strings | Max 500 items. Must be valid Funding Stage values |
funding_date | integer | Days since last funding: 30, 60, 90, 180, 270, 365 |
last_funding.min | string | Must be valid Revenue Range value |
last_funding.max | string | Must be valid Revenue Range value. Must be ≥ min |
total_funding.min | string | Must be valid Revenue Range value |
total_funding.max | string | Must 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.
| Field | Type | Constraints |
|---|---|---|
include | array of strings | Max 20 items. Must be valid Technology value |
exclude | array of strings | Max 20 items. Must be valid Technology value |
{
"company_technology": {
"include": ["Salesforce", "HubSpot", "AWS"],
"exclude": ["Azure"]
}
}company_founded
Filter by company founding year.
| Field | Type | Constraints |
|---|---|---|
min | integer | 1900 - current year |
max | integer | 1900 - current year. Must be ≥ min |
include_unknown_founded | boolean | Include 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.
| Field | Type | Constraints |
|---|---|---|
timeframe_month | integer | 3, 6, 12, or 24 |
min | integer | -100 to 10,000 (percentage) |
max | integer | -100 to 10,000 (percentage). Must be ≥ min |
departments | array of strings | Max 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.
| Type | Constraints |
|---|---|
| array of strings | Max 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.
| Field | Type | Constraints |
|---|---|---|
min | integer | 0-5,000 |
max | integer | 0-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.
| Field | Type | Constraints |
|---|---|---|
department | string | Must be valid Department value |
min | integer | 0-100,000 |
max | integer | 0-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.
| Type | Constraints |
|---|---|
| array of strings | Must 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
C-Suite
Director
Entry
Founder/Owner
Head
Intern
Manager
Partner
Senior
Vice PresidentEmployee Range Values
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
OtherFunding Stage Values
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
UndisclosedDepartment Values
Top-Level Departments:
C-Suite
Consulting
Design
Education & Coaching
Engineering & Technical
Finance
Human Resources
Information Technology
Legal
Marketing
Medical & Health
Operations
Product
SalesHeadcount 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
TradesOther Enum Values
The following enums have extensive lists. Please refer to their dedicated pages:
| Enum | Count | Link |
|---|---|---|
| Industries | 256 values | View all Industries |
| Technologies | 4,946 values | View all Technologies |
| NAICS codes | Extensive list | View all NAICS codes |
| SIC codes | Extensive list | View all SIC codes |
| MX providers | 107 values | View all MX providers |
Forbidden Filters
The following filters are blocked for the public API and will return an error if used:
| Filter | Blocked For |
|---|---|
company_intent | Both /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
}Search People with Boolean Job Title Search
{
"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
}