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.

Some filters require a paid plan — the Minimum plan is called out at the top of each filter’s detail section below. Sending a filter that requires a higher plan than your current subscription returns HTTP 400 with error_code: "PLAN_REQUIRED" and a filter_error listing each rejected filter and its minimum plan (e.g. company_key_execs (PRO+)). See the error code tables on the /search-person and /search-company pages.

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
MX providers	Email providers (5 filterable values, 105 response values)	View all MX providers

Quick Reference

Person Filters

Available only for /search-person:

Filter	Type	Description	Enum Values
`person_search`	PersonSearchFilter	Search people by name, company name, or company domain	—
`person_name`	PersonNameFilter	Strict name-only search (a simpler alternative to `person_search` when matching exact name strings)	—
`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	—
`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	—
`person_education`	EducationFilter	Filter by school, degree, field of study and graduation year	See degree values below
`person_awards_certifications`	AwardsCertificationsFilter	Filter by certifications and awards, their issuers and years	—
`person_past_job_title`	PastJobTitleFilter	Filter by job titles held before the current role	—
`person_past_company`	PastCompanyFilter	Filter by companies worked at before the current employer	—

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 with source selection	—
`company_attributes`	AttributesFilter	Filter by company attributes	—
`company_naics`	IncludeExclude	Filter by NAICS codes	Use Search Suggestions API
`company_sics`	IncludeExclude	Filter by SIC codes	Use Search Suggestions API
`company_revenue`	RevenueFilter	Filter by revenue range	—
`company_type`	CompanyTypeFilter	Filter by company type, subtypes, and business model	See values below
`company_funding`	FundingFilter	Filter by funding details, investors, and accelerators	Funding stages; investors & accelerators via Search Suggestions API
`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`	JobPostingFilter	Filter by job posting titles with boolean search support	—
`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
`company_headcount_by_location`	HeadcountByLocationFilter	Filter by employee count in specific countries	Countries via Search Suggestions API
`company_news`	CompanyNewsFilter	Filter by recent company news	See news categories below
`company_intent`	CompanyIntentFilter	Filter companies by buying-intent topics they’re researching	—
`company_key_execs`	KeyExecsEventsFilter	Filter by executive leadership changes	See event types below
`company_website_traffic`	WebsiteTrafficFilter	Filter by website traffic volume and trends	Traffic countries via Search Suggestions API
`company_key_customers`	KeyCustomersFilter	Filter by known customers of the company	Use Search Suggestions API
`company_lookalike`	LookalikeFilter	Find similar companies with AI similarity search	—
`company_website_search`	WebsiteSearchFilter	Full-text search across crawled company websites	—
`company_icp`	ICPFilter	Filter by ideal customer profile signals	See ICP values below; titles, industries, geographic markets & departments via Search Suggestions API
`company_google_discovery`	GoogleDiscoveryFilter	Find companies by SEO keywords they rank for	Use Search Suggestions API
`company_products_services`	ProductsServicesFilter	Filter by products and service tags	Products & services via Search Suggestions API
`company_integrations`	IntegrationsFilter	Filter by integrations mentioned on company website	Use Search Suggestions API
`company_awards`	AwardsFilter	Filter by awards and recognitions	Awards & compliance via Search Suggestions API
`company_operating_languages`	OperatingLanguagesFilter	Filter by languages the company operates in	Use Search Suggestions API

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.

persona_ids is dashboard-only and is rejected with INVALID_FILTERS. Personas are saved filter sets that only the dashboard expands, so send the filters they contain directly instead. The same applies to the saved-list filters (person_saved_at_list, person_job_change_tracking_list, person_contact_details_list, person_duplicate_control_list, company_saved_at_list) and to person_duplicate_control / company_duplicate_control, which all depend on dashboard-side list state.

Person Filters

person_search

Search for people by first name, last name, company name, or company domain.

Field	Type	Constraints
`include`	array of strings	Max 500 items. Each term: 1-100 characters
`exclude`	array of strings	Max 500 items. Each term: 1-100 characters
`match_mode`	string	`"SMART"` (default) or `"STRICT"`. `SMART` searches person and company fields; `STRICT` is name-only matching

For name-only searches, person_name is also accepted and behaves like person_search with match_mode: "STRICT". Do not send both person_name and person_search in the same request.


{
	"person_search": {
		"include": ["John Smith", "Jane Doe"],
		"exclude": ["Bob Wilson"],
		"match_mode": "SMART"
	}
}

person_name

Strict name-only matching. Use this when you have exact name strings to look up. For broader matching that also searches company name and domain, use person_search instead. Do not send both person_name and person_search in the same request.

Field	Type	Constraints
`include`	array of strings	Max 500 items. Each term: 1-100 characters
`exclude`	array of strings	Max 500 items. Each term: 1-100 characters
`person_oids`	array of strings	Max 50 Prospeo person IDs. Each: 10-50 characters


{
	"person_name": {
		"include": ["John Smith", "Jane Doe"]
	}
}

Use person_oids to pull specific people back by their Prospeo person ID, for example to refresh records you already stored. The IDs are the person.person_id values returned by /search-person and /enrich-person.


{
	"person_name": {
		"person_oids": ["507f1f77bcf86cd799439011", "507f191e810c19729de860ea"]
	}
}

IDs that no longer resolve are skipped. If none of them resolve and no include terms were sent, the filter contributes nothing and the search runs against your remaining filters instead of returning no results. Check the returned person_id values against what you asked for rather than assuming every ID matched.

person_oids is OR’d with include, so a request carrying both returns the listed people plus everyone matching the name terms. exclude still applies on top of the result.

person_name_or_job_title

Quick search filter that matches across both person name and job title fields. For structured people searches, prefer person_search and person_job_title.

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_mode`	string	`"CONTAINS"`, `"EXACT"`, or `"SIMILAR"`. Controls how titles are matched. Recommended for standard search: `"CONTAINS"`
`smart_intensity`	string	Optional. Only used when `match_mode` is `"SIMILAR"`. Valid values: `"LOOSE"` (default), `"NORMAL"`, `"STRICT"`
`boolean_search`	string	Max 500 terms, max 5 parenthesis depth, each term 2-100 chars

match_mode values: CONTAINS matches titles containing the search term as a substring, EXACT matches the full job title exactly, and SIMILAR expands the search to related titles (for example, “CEO” can also match “Chief Executive Officer”). Send match_mode explicitly so the matching behavior is predictable.

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_mode": "CONTAINS"
	}
}

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

You cannot use include and exclude at the same time for this filter.


{
	"person_department": {
		"include": ["Sales", "Marketing"]
	}
}

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

You cannot use include and exclude at the same time for this filter.


{
	"person_seniority": {
		"include": ["C-Suite", "Vice President", "Director"]
	}
}

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, and copied exactly. Qualifiers differ by place — some locations use a state or province, others a country — so send back the value you received rather than composing one yourself.


{
	"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
	}
}

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	1-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

Minimum plan: Growth

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
	}
}

person_education

Minimum plan: Growth

Filter by education history: school, degree, field of study and graduation year. Include-only, there is no exclude.

Field	Type	Constraints
`schools`	array of strings	Max 20 items. Each: max 100 characters. Contains matching
`degrees`	array of strings	Must be valid Education Degree values. Case-insensitive
`fields_of_study`	array of strings	Max 20 items. Each: max 100 characters. Contains matching
`graduated_min`	integer	Year between 1950 and the current year
`graduated_max`	integer	Year between 1950 and the current year. Must be ≥ `graduated_min`

Values inside a field are OR’d, and the fields are AND’d with each other. {"schools": ["Stanford", "Berkeley"], "degrees": ["mba"]} means Stanford or Berkeley, and an MBA.

schools and fields_of_study have no Search Suggestions support, so send the names as they appear on a profile. Matching is accent-folded and case-insensitive.

schools and fields_of_study are matched against the same stored education text, which holds the institution and the degree or field together. A term therefore matches either part: {"schools": ["Computer Science"]} will match people whose field of study is Computer Science. Treat the two fields as two contains searches over the same text rather than as searches scoped to the school name or the field name.

Matching is not word-bounded either, so short abbreviations are unsafe: "MIT" also matches “Smith College”. Send full institution names.


{
	"person_education": {
		"schools": ["Stanford University", "Massachusetts Institute of Technology"],
		"degrees": ["masters", "mba"],
		"fields_of_study": ["Computer Science"],
		"graduated_min": 2010,
		"graduated_max": 2018
	}
}

A graduation year range binds to the record it is checked against, so schools plus a year range will not match someone whose school record graduated outside the range. schools and fields_of_study may still match different records from each other, but each matched record must independently fall inside the range, so Stanford in 2010 plus Computer Science in 2020 does not satisfy a 2010 range. degrees is stored in a separate place entirely and is never record-bound.

person_awards_certifications

Minimum plan: Growth

Filter by certifications and awards, their issuing organizations, and the years they were received. Include-only, there is no exclude.

Field	Type	Constraints
`certifications`	array of strings	Max 20 items. Each: max 100 characters. Contains matching
`certification_issuers`	array of strings	Max 20 items. Each: max 100 characters. Matches the start of the issuer name, not the certification name
`certification_year_min`	integer	Year between 1950 and the current year. Requires `certifications` or `certification_issuers`
`certification_year_max`	integer	Year between 1950 and the current year. Must be ≥ the min. Requires `certifications` or `certification_issuers`
`awards`	array of strings	Max 20 items. Each: max 100 characters. Contains matching
`award_issuers`	array of strings	Max 20 items. Each: max 100 characters. Matches the start of the issuer name, not the award name
`award_year_min`	integer	Year between 1950 and the current year. Requires `awards` or `award_issuers`
`award_year_max`	integer	Year between 1950 and the current year. Must be ≥ the min. Requires `awards` or `award_issuers`

Values inside a field are OR’d, and the fields are AND’d with each other. The certification block and the award block are also AND’d, so sending both returns only people who have a matching certification and a matching award.

Issuer terms are anchored to the beginning of the issuer name, so "Amazon" matches “Amazon Web Services” but "Web Services" does not.

certifications and awards are matched against the whole stored record, which holds the name and the issuer together, so a name term also matches issuer text: {"certifications": ["Amazon"]} returns people holding any certification issued by Amazon. Matching is not word-bounded, so short terms match inside longer words. Use the issuer fields when you mean the issuer, and send full names rather than abbreviations.

A year range on its own is rejected with INVALID_FILTERS. Certification years require certifications or certification_issuers, and award years require awards or award_issuers, because a bare year range matches nearly everyone holding any record.


{
	"person_awards_certifications": {
		"certifications": ["AWS Certified Solutions Architect"],
		"certification_issuers": ["Amazon Web Services"],
		"certification_year_min": 2020,
		"certification_year_max": 2025
	}
}

Year ranges bind to the same record as the name or issuer they are sent with, so a 2020-2025 range on a certification will not match a person whose certification was issued in 2015 just because a different certification of theirs falls in range.

person_past_job_title

Minimum plan: Growth

Filter by job titles a person held before their current role. This is a separate filter from person_job_title, which always matches the current title.

Field	Type	Constraints
`include`	array of strings	Required. Max 50 items. Each title: max 100 characters
`match_mode`	string	`"EXACT"` (default) or `"CONTAINS"`
`titles_logic`	string	`"OR"` (default) or `"AND"`. How the listed past titles combine with each other
`combine_with_current`	string	`"OR"` (default) or `"AND"`. How this filter combines with `person_job_title`

match_mode values: EXACT matches a whole stored title, so "attorney" does not match “Attorney General”. CONTAINS matches anywhere inside a title. Because the default is EXACT, send titles that exist as whole values: the Search Suggestions API job_title_search field is the source for those, and CONTAINS is the safer choice for free-text terms.

titles_logic values: OR returns people who held any of the listed titles at some point, AND returns people who held all of them.


{
	"person_job_title": {
		"include": ["VP of Sales"],
		"match_mode": "CONTAINS"
	},
	"person_past_job_title": {
		"include": ["Account Executive"],
		"match_mode": "EXACT",
		"combine_with_current": "AND"
	}
}

combine_with_current only has an effect when person_job_title is also sent with an include list or a boolean_search expression. On its own, person_past_job_title returns people who previously held the titles regardless of what they do now, and "OR" and "AND" behave identically. An exclude-only person_job_title does not count as a current-title match.

person_past_company

Minimum plan: Growth

Filter by companies a person worked at before their current employer. Companies are selected by Prospeo company ID, not by name.

Field	Type	Constraints
`company_oids`	array of strings	Required. Max 100 Prospeo company IDs. Each: 10-50 characters
`combine_with_current`	string	`"OR"` (default) or `"AND"`

combine_with_current values: OR returns people who work or worked at the listed companies, AND returns only people who worked there previously, which pairs with the company filter to express “currently at X and previously at Y”.


{
	"person_past_company": {
		"company_oids": ["507f1f77bcf86cd799439011", "507f191e810c19729de860ea"],
		"combine_with_current": "AND"
	}
}

There is no company name lookup on this filter. Get the IDs from the company.company_id field returned by /search-company or /enrich-company first, then pass them here. If none of the IDs resolve, the search returns no results rather than ignoring the filter.

Company Filters

company

Filter by company name, website, or exact company ID.

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
`company_oids.include`	array of strings	Prospeo company IDs. Total `company_oids` ≤ 5,000. Only valid for `/search-person`
`company_oids.exclude`	array of strings	Prospeo company IDs. Only valid for `/search-person`

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_oids is the exact-match version of this filter, and it is what the dashboard’s Company filter sends. Where a names entry can match several unrelated companies that share a name, a company ID matches exactly one. On /search-person it returns people whose current employer is one of the listed companies.

Company IDs come from the company_id field of any company object we return — /search-company results, /search-person results, or company enrichment. See the Company object page.


{
	"company": {
		"company_oids": {
			"include": ["cccc7c7da6116a8830a07100", "cccc7c7da6116a8830a07101"],
			"exclude": []
		}
	}
}

company_oids is rejected with INVALID_FILTERS on /search-company. Use names or websites there.

company.company_list_oids and company.temp_matching_oids appear in dashboard payloads but have no public equivalent — they reference a saved company list and a CSV/selection matching session that only exist inside the dashboard. Use company_oids, names or websites instead.

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"],
		"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 across multiple company data sources.

Field	Type	Constraints
`include`	array of strings	Max 20 items. Each: 3-100 characters
`exclude`	array of strings	Max 20 items. Each: 3-100 characters
`include_all`	boolean	If `true`, ALL include keywords must match (AND logic). Default: `false`
`search_everywhere`	boolean	If `true` (default), searches all sources. If `false`, only searches selected `sources`
`sources`	array of strings	Only used when `search_everywhere` is `false`. Valid values: `"specialties"`, `"social_media_description"`, `"seo_description"`, `"ai_description"`, `"products_services"`, `"website_pages"`

At least one include keyword is required. You cannot use exclude keywords without at least one include keyword.


{
	"company_keywords": {
		"include": ["saas", "b2b", "enterprise"],
		"exclude": ["consumer"],
		"include_all": false,
		"search_everywhere": false,
		"sources": ["specialties", "seo_description", "website_pages"]
	}
}

company_attributes

Filter by company attributes. Unless noted otherwise in the tables below, fields are boolean or null. Set true to require the attribute, false to exclude companies with it, or omit / set null to ignore.

General

Field	Description
`b2b`	Company is B2B
`demo`	Offers demo
`freetrial`	Offers free trial
`downloadable`	Has downloadable product
`mobileapps`	Has mobile apps
`onlinereviews`	Has online reviews
`pricing`	Shows pricing on website
`uses_ai`	Company uses AI

Platform Features

Field	Description
`has_api`	Has a public API
`has_chrome_extension`	Has a Chrome extension
`has_sso`	Supports SSO
`has_uptime_guarantee`	Provides uptime guarantee
`has_open_source`	Has open-source components
`has_marketplace`	Has an app marketplace or ecosystem

Content & Marketing

Field	Description
`has_blog`	Has a blog
`has_podcast`	Has a podcast
`has_community_forum`	Has a community forum
`has_knowledge_base`	Has a knowledge base
`has_academy`	Has a training academy
`has_affiliate_program`	Has an affiliate program
`has_case_studies`	Has published case studies
`has_testimonials`	Has published testimonials

Support Channels

Field	Description
`has_phone_support`	Offers phone support
`has_email_support`	Offers email support
`has_chat_support`	Offers live chat support
`has_ticket_support`	Offers ticket-based support
`has_social_support`	Offers support via social media

Certifications & Compliance

Field	Description
`has_soc2`	SOC 2 certified
`has_iso27001`	ISO 27001 certified
`has_gdpr`	GDPR compliant
`has_hipaa`	HIPAA compliant
`has_ccpa`	CCPA compliant
`has_pci_dss`	PCI DSS compliant
`other_compliance`	Array of strings (max 50 items, each max 50 chars). Custom compliance/certification names
`compliance_match_mode`	`"EXACT"` (default) or `"CONTAINS"`. Controls how `other_compliance` values are matched
`has_esg_reports`	Publishes ESG reports

Company Presence

Field	Description
`data_residency`	String (max 50 chars). Data residency region (e.g. `"EU"`, `"US"`)
`has_physical_offices`	Has physical office locations
`is_venture_backed`	Company is venture-backed
`is_publicly_traded`	Company is publicly traded


{
	"company_attributes": {
		"b2b": true,
		"uses_ai": true,
		"has_api": true,
		"has_sso": true,
		"has_soc2": true,
		"has_gdpr": true,
		"has_case_studies": true,
		"has_chat_support": true
	}
}

company_naics

Filter by NAICS (North American Industry Classification System) codes. Use the Search Suggestions API naics_search field to resolve codes, either by digit prefix or by label.

Field	Type	Constraints
`include`	array of integers	Max 100 items. Each code: 1-1,000,000
`exclude`	array of integers	Max 100 items. Each code: 1-1,000,000


{
	"company_naics": {
		"include": [541511, 541512],
		"exclude": [236220]
	}
}

company_sics

Filter by SIC (Standard Industrial Classification) codes. Use the Search Suggestions API sic_search field to resolve codes, either by digit prefix or by label.

Field	Type	Constraints
`include`	array of integers	Max 100 items. Each code: 1-1,000,000
`exclude`	array of integers	Max 100 items. Each code: 1-1,000,000


{
	"company_sics": {
		"include": [7371, 7372],
		"exclude": [1521]
	}
}

company_revenue

Minimum plan: Starter

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, subtypes, business model, and company characteristic flags.

Minimum plan: Free

You may also send a plain string value such as "Private"; it is treated as status.

Field	Type	Constraints
`status`	string or null	Company status. Valid values: `"Private"`, `"Public"`, `"Non Profit"`, `"Other"`
`subtypes`	object or null	Object with `include` and `exclude` arrays. See Subtype values below
`business_model`	string, array of strings, or null	See Business Model values below
`is_retail`	boolean or null	Company is a retail business
`is_marketplace`	boolean or null	Company operates a marketplace
`is_mainly_ai`	boolean or null	Company is primarily an AI company
`is_mainly_crypto`	boolean or null	Company is primarily a crypto/blockchain company
`multi_product`	boolean or null	Company offers multiple products
`has_free_tier`	boolean or null	Company offers a free tier
`is_self_serve`	boolean or null	Company has a self-serve model
`is_sales_led`	boolean or null	Company has a sales-led model
`has_usage_pricing`	boolean or null	Company uses usage-based pricing
`has_subscription`	boolean or null	Company uses subscription pricing
`has_enterprise_plan`	boolean or null	Company offers an enterprise plan
`has_public_pricing`	boolean or null	Company shows pricing publicly


{
	"company_type": {
		"status": "Private",
		"subtypes": {
			"include": ["SaaS", "Platform"]
		},
		"business_model": "b2b",
		"is_mainly_ai": true,
		"has_public_pricing": true
	}
}

company_funding

Minimum plan: Starter

Filter by funding information, investors, and accelerator participation. 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`
`investors`	array of strings	Max 10 items. Each: max 100 characters. Filter by investor names
`was_in_accelerator`	boolean	Filter for companies that participated in an accelerator
`accelerator_name`	string	Max 100 characters. Specific accelerator name (only used when `was_in_accelerator` is `true`)


{
	"company_funding": {
		"stage": ["Series A", "Series B", "Series C"],
		"funding_date": 365,
		"last_funding": {
			"min": "1M",
			"max": "100M"
		},
		"total_funding": {
			"min": "5M",
			"max": "500M"
		},
		"investors": ["Sequoia Capital", "Andreessen Horowitz"],
		"was_in_accelerator": true,
		"accelerator_name": "Y Combinator"
	}
}

company_technology

Minimum plan: Starter

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: `false`


{
	"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

Minimum plan: Starter

Filter by job titles the company is actively hiring for. Supports include/exclude lists or advanced boolean search expressions.

Field	Type	Constraints
`include`	array of strings	Max 500 items. Each title: 1-200 characters
`exclude`	array of strings	Max 500 items. Each title: 1-200 characters
`match_type`	string	`"contains"` (default) or `"exact"`. Controls normal include/exclude title matching
`boolean_search`	string	Max 500 terms, max 5 parenthesis depth, each term 2-100 chars

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

Standard Mode


{
	"company_job_posting_hiring_for": {
		"include": ["Software Engineer", "Sales Manager"],
		"exclude": ["Intern"],
		"match_type": "contains"
	}
}

Boolean search syntax matches person_job_title. See the Boolean Search Syntax reference above.

company_job_posting_quantity

Minimum plan: Starter

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. The filterable values are Microsoft, Google, Proofpoint, Mimecast and Other. Every other email provider is grouped under Other. See MX providers for details.

Type	Constraints
array of strings	Must be valid Email Provider values


{
	"company_email_provider": ["Google", "Microsoft"]
}

company_headcount_by_location

Minimum plan: Growth

Filter by employee count in specific countries. Each entry specifies a country and a headcount range. Max 10 entries.

Field	Type	Constraints
`entries`	array of objects	1-10 entries
`entries[].country`	string	Country name. 1-100 characters
`entries[].min_headcount`	integer or null	0-1,000,000. At least one of `min_headcount` or `max_headcount` required per entry
`entries[].max_headcount`	integer or null	0-1,000,000. Must be ≥ `min_headcount`


{
	"company_headcount_by_location": {
		"entries": [
			{
				"country": "United States",
				"min_headcount": 50,
				"max_headcount": 500
			},
			{
				"country": "Germany",
				"min_headcount": 10,
				"max_headcount": null
			}
		]
	}
}

company_news

Filter companies by recent news mentions, topics, and categories.

Field	Type	Constraints
`keywords`	array of strings or null	Max 20 items. Each: max 100 characters
`categories`	array of strings or null	Max 10 items. Must be valid News Category values
`timeframe_days`	integer	`60`, `90`, `180`, or `365`. Default: `90`

At least one of keywords or categories is required.


{
	"company_news": {
		"keywords": ["acquisition", "expansion"],
		"categories": ["Mergers & Acquisitions", "Expansion"],
		"timeframe_days": 180
	}
}

company_intent

Filter companies by buying-intent topics they’re researching.

Despite the field name, topic_ids takes topic names, not numeric IDs. Use the topic exactly as it is written in your Prospeo dashboard under Intent settings, for example "CRM Software". Numeric IDs are rejected.

Intent topics are selected in your Prospeo dashboard (Intent settings) and are not enumerable via the public API. A topic your account has not selected there is rejected, even if it is a real topic — so add it in the dashboard first, then use it here.

Field	Type	Constraints
`topic_ids`	array of strings	1-30 items, each up to 120 characters. Each must be the name of a topic selected on your account.
`in_depth_research`	boolean	Filter for companies in the in-depth-research intent stage. Default: `false`
`active_research`	boolean	Filter for companies in the active-research intent stage. Default: `false`
`early_research`	boolean	Filter for companies in the early-research intent stage. Default: `false`

If all three stage flags are left at false, every intent stage is matched.


{
	"company_intent": {
		"topic_ids": ["CRM Software", "Marketing Automation"],
		"active_research": true,
		"in_depth_research": true
	}
}

A real topic your account has not selected returns INVALID_FILTERS and names it in filter_error:


{
	"error": true,
	"error_code": "INVALID_FILTERS",
	"filter_error": "Topics ['Sales Enablement'] are not configured for your team"
}

A name that is not in the topic taxonomy at all is a different message on the same code, "filter_error": "Invalid topic name: Sales Enablment", and it is checked first, so a typo is reported before the not-selected check runs. Branch on error_code, not on the message text.

company_intent filters the result set; it does not add intent fields to the response. Use it to narrow which companies come back, then read the intent detail for those companies in the dashboard.

company_key_execs

Minimum plan: Pro

Filter companies by recent executive leadership changes (departures and appointments).

Field	Type	Constraints
`event_types`	array of strings	1-10 items. Must be valid Executive Event Type values
`timeframe_days`	integer	`60`, `90`, `180`, or `365`. Default: `90`


{
	"company_key_execs": {
		"event_types": ["CEO Departed", "CTO Appointed", "Any C-Level Departed"],
		"timeframe_days": 180
	}
}

company_website_traffic

Minimum plan: Pro

Filter companies by website traffic volume, growth trends, and audience countries.

Field	Type	Constraints
`min_monthly_visits`	integer or null	0-100,000,000
`max_monthly_visits`	integer or null	0-100,000,000. Must be ≥ `min_monthly_visits`
`visit_change`	object or null	Traffic growth/decline filter. See nested fields below
`visit_change.period`	string	`"monthly"`, `"quarterly"`, or `"yearly"`. Default: `"monthly"`
`visit_change.min_change`	float or null	-100 to 10,000 (percentage)
`visit_change.max_change`	float or null	-100 to 10,000 (percentage). Must be ≥ `min_change`
`top_countries`	array of strings or null	Max 5 country names
`min_country_pct`	float or null	0-100. Minimum traffic % from listed countries. Only used with `top_countries`
`max_country_pct`	float or null	0-100. Must be ≥ `min_country_pct`. Only used with `top_countries`

At least one criterion is required (visits range, visit change, or top countries).


{
	"company_website_traffic": {
		"min_monthly_visits": 10000,
		"max_monthly_visits": 1000000,
		"visit_change": {
			"period": "quarterly",
			"min_change": 10,
			"max_change": 200
		},
		"top_countries": ["United States", "United Kingdom"],
		"min_country_pct": 20
	}
}

company_key_customers

Minimum plan: Growth

Find companies whose customers include specific brands. Include-only — no exclude support.

Field	Type	Constraints
`include`	array of strings	Max 100 items. Each: max 100 characters


{
	"company_key_customers": {
		"include": ["Google", "Microsoft", "Amazon"]
	}
}

company_lookalike

Minimum plan: Starter

Find companies similar to seed companies using AI similarity search. Four mutually exclusive modes are available — use exactly one.

Field	Type	Constraints
`company_oids`	array of strings	Mode A: Max 10 seed company IDs
`icp_text`	string or null	Mode B: Free-text ICP description. Max 5,000 characters
`domain`	string or null	Mode D: A company domain to find similar companies
`person_oids`	array of strings	Mode C: Max 10 seed person IDs. Only valid for `/search-person`
`match_all`	boolean	`true` = match ALL seeds (intersection), `false` = match ANY seed (union). Default: `false`
`same_language`	boolean	Require same website language as seed. Default: `false`
`minimum_tier`	string	`"T1"` (most similar), `"T2"`, or `"T3"` (broadest). Default: `"T3"`

Exactly one mode must be used: company_oids, icp_text, domain, or person_oids. They cannot be combined.

Mode C (person_oids) is only available for /search-person. It will be rejected for /search-company.

Mode A: Company Seeds


{
	"company_lookalike": {
		"company_oids": ["507f1f77bcf86cd799439011", "507f1f77bcf86cd799439012"],
		"minimum_tier": "T2",
		"match_all": false
	}
}

Mode B: ICP Text


{
	"company_lookalike": {
		"icp_text": "B2B SaaS companies in the sales intelligence space with 50-500 employees",
		"minimum_tier": "T2"
	}
}

Mode D: Domain


{
	"company_lookalike": {
		"domain": "prospeo.io",
		"minimum_tier": "T2",
		"same_language": true
	}
}

company_website_search

Minimum plan: Pro

Full-text search across crawled company website pages. Can search by keywords across different page sections, filter by page type, and filter by website structure flags.

Field	Type	Constraints
`include_keywords`	array of strings or null	Max 10 items. Each: max 200 characters
`exclude_keywords`	array of strings or null	Max 10 items. Each: max 200 characters. Requires at least one `include_keywords`
`match_mode`	string	`"any"` (default) or `"all"`
`search_in`	object or null	Controls which parts of crawled pages to search. See nested fields below
`search_in.page_body`	boolean	Search page body text. Default: `true`
`search_in.page_titles`	boolean	Search page titles. Default: `true`
`search_in.urls_only`	boolean	Search URLs only. Default: `false`
`search_in.headings_only`	boolean	Search headings only. Default: `false`
`search_in.seo_description`	boolean	Search SEO meta descriptions. Default: `false`
`page_scope`	array of strings or null	Max 5 items. Valid values: `"homepage"`, `"product"`, `"blog"`, `"careers"`, `"about"`
`url_contains`	string or null	Max 200 characters. Filter pages whose URL contains this string
`has_persona_pages`	boolean or null	Company website has persona/use-case pages
`has_industry_pages`	boolean or null	Company website has industry-specific pages
`has_solution_pages`	boolean or null	Company website has solution pages
`has_careers_page`	boolean or null	Company website has a careers page
`has_status_page`	boolean or null	Company website has a status page
`has_sla_page`	boolean or null	Company website has an SLA page
`has_developer_docs_page`	boolean or null	Company website has developer documentation
`has_investor_page`	boolean or null	Company website has an investor relations page
`has_security_page`	boolean or null	Company website has a security/trust page
`has_comparison_pages`	boolean or null	Company website has competitor comparison pages

You cannot use exclude_keywords without at least one include_keywords. When providing keywords with search_in, at least one search scope field must be true.


{
	"company_website_search": {
		"include_keywords": ["enterprise pricing", "SOC 2"],
		"exclude_keywords": ["free trial"],
		"match_mode": "any",
		"search_in": {
			"page_body": true,
			"page_titles": true
		},
		"page_scope": ["product", "about"],
		"url_contains": "pricing",
		"has_developer_docs_page": true,
		"has_security_page": true
	}
}

company_icp

Minimum plan: Growth

Filter by Ideal Customer Profile (ICP) signals — the types of customers the company targets.

Field	Type	Constraints
`titles_include`	array of strings	Max 20 items. Each: max 100 characters. Job titles the company sells to
`titles_exclude`	array of strings	Max 20 items. Each: max 100 characters. Requires at least one `titles_include`
`company_sizes`	array of strings	Max 5 items. See ICP Company Size values
`industries`	array of strings	Max 10 items. Each: max 100 characters
`geographic_markets`	array of strings	Max 10 items. Country names or ISO2 codes (e.g., `"US"`, `"Germany"`)
`geographic_scope`	string or null	`"single_country"` or `"multi_country"`
`departments`	object or null	See nested department fields below
`departments.include`	array of strings	Max 15 items. Must be valid ICP Department values
`departments.match_mode`	string	`"any"` (OR) or `"all"` (AND). Default: `"any"`
`departments.other`	array of strings	Max 5 custom department names. Each: max 100 characters


{
	"company_icp": {
		"titles_include": ["CTO", "VP Engineering", "Head of DevOps"],
		"company_sizes": ["smb", "midmarket", "enterprise"],
		"industries": ["Software Development", "Financial Services"],
		"geographic_markets": ["US", "GB", "DE"],
		"geographic_scope": "multi_country",
		"departments": {
			"include": ["Engineering", "IT", "Security"],
			"match_mode": "any"
		}
	}
}

company_google_discovery

Minimum plan: Pro

Find companies based on SEO keywords they rank for.

Field	Type	Constraints
`seo_keywords`	array of strings	1-100 items. Each: max 100 characters


{
	"company_google_discovery": {
		"seo_keywords": ["email finder", "sales intelligence", "lead generation"]
	}
}

company_products_services

Filter by products and service tags associated with the company.

Field	Type	Constraints
`products_include`	array of strings	Max 20 items. Each: max 100 characters
`products_exclude`	array of strings	Max 10 items. Each: max 100 characters. Requires at least one include
`products_match_all`	boolean	If `true`, ALL included products must match. Default: `false`
`service_tags_include`	array of strings	Max 20 items. Each: max 100 characters
`service_tags_exclude`	array of strings	Max 10 items. Each: max 100 characters. Requires at least one include
`service_tags_match_all`	boolean	If `true`, ALL included service tags must match. Default: `false`

You must include at least one product or service tag before using excludes. Exclude-only payloads are rejected.


{
	"company_products_services": {
		"products_include": ["CRM", "email automation"],
		"products_exclude": ["accounting"],
		"products_match_all": false,
		"service_tags_include": ["consulting", "implementation"],
		"service_tags_match_all": false
	}
}

company_integrations

Minimum plan: Growth

Filter by integrations mentioned on the company’s website.

Field	Type	Constraints
`include`	array of strings	Max 20 items. Each: max 100 characters
`exclude`	array of strings	Max 10 items. Each: max 100 characters. Requires at least one `include`

You must include at least one integration before using excludes. Exclude-only payloads are rejected.


{
	"company_integrations": {
		"include": ["Salesforce", "HubSpot", "Slack"],
		"exclude": ["Zendesk"]
	}
}

company_awards

Minimum plan: Growth

Filter by awards and recognitions the company has received.

Use company_awards for award names. Use company_attributes for standard certifications and other compliance fields such as has_soc2, has_iso27001, other_compliance, and compliance_match_mode.

Field	Type	Constraints
`include`	array of strings	Max 50 items. Each: max 100 characters
`match_mode`	string	`"EXACT"` (default) or `"CONTAINS"`. `EXACT` matches the full award name; `CONTAINS` matches as a substring


{
	"company_awards": {
		"include": ["Inc 5000", "Deloitte Fast 500", "Forbes Cloud 100"],
		"match_mode": "EXACT"
	},
	"company_attributes": {
		"has_soc2": true,
		"has_iso27001": true,
		"other_compliance": ["ISO 9001:2015"],
		"compliance_match_mode": "CONTAINS"
	}
}

company_operating_languages

Filter by languages the company operates in. Include-only.

Field	Type	Constraints
`include`	array of strings	Max 10 items. Each: max 50 characters. Language names (e.g. `"English"`, `"French"`)


{
	"company_operating_languages": {
		"include": ["English", "French", "German"]
	}
}

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.

Education Degree Values

Used for person_education.degrees. Values are case-insensitive and any other value is rejected with INVALID_FILTERS.


high school
associate
bachelors
masters
mba
phd
professional
diploma
vocational
other

other is a shorthand that matches both diploma and vocational, so sending it alongside either of those is redundant.

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

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

Used for company_type.status:


Private
Public
Non Profit
Other

Company Subtype Values

Used for company_type.subtypes.include:


SaaS
Marketplace
E-commerce
Agency
Consulting
Manufacturing
Media/Publisher
Education
Non-Profit
Government
FinTech
HealthTech
AI/ML
Hardware
Professional Services
Platform
Data/Analytics
Franchise
Logistics
Real Estate
Legal
Insurance
Retail
Hospitality
Food & Beverage
Construction
Telecommunications

Business Model Values

Used for company_type.business_model:


b2b
b2c
b2b2c
d2c
marketplace
franchise
non_profit
government

News Category Values

Used for company_news.categories:


Funding & Investment
Mergers & Acquisitions
Product Launch
Partnership
Expansion
Layoffs & Restructuring
IPO
Leadership Change
Legal & Regulatory
Awards & Recognition

Executive Event Type Values

Used for company_key_execs.event_types:


CEO Departed
CEO Appointed
CTO Departed
CTO Appointed
CFO Departed
CFO Appointed
COO Departed
COO Appointed
CMO Departed
CMO Appointed
CRO Departed
CRO Appointed
VP of Sales Departed
VP of Sales Appointed
VP of Marketing Departed
VP of Marketing Appointed
VP of Engineering Departed
VP of Engineering Appointed
Any C-Level Departed
Any C-Level Appointed
Any VP Departed
Any VP Appointed
Any Director Departed
Any Director Appointed

ICP Department Values

Used for company_icp.departments.include:


Engineering
Sales
Marketing
Finance
HR
Operations
IT
Legal
Customer Success
Procurement
Data
Security
Design
SMB Owners
Consumers

ICP Company Size Values

Used for company_icp.company_sizes:


micro
smb
midmarket
enterprise
large_enterprise

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:

Enum	Count	Link
Industries	256 values	View all Industries
Technologies	4,946 values	View all Technologies
MX providers	5 filterable values, 105 response values	View all MX providers

Complete Example Requests

Search People by Job Title, Seniority, and Company


{
	"filters": {
		"person_job_title": {
			"include": ["CEO", "CTO", "VP Engineering"],
			"match_mode": "CONTAINS"
		},
		"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
}

Search Companies by Website Content and Traffic


{
	"filters": {
		"company_website_search": {
			"include_keywords": ["enterprise pricing", "SOC 2 compliance"],
			"match_mode": "any",
			"has_security_page": true,
			"has_developer_docs_page": true
		},
		"company_website_traffic": {
			"min_monthly_visits": 50000,
			"visit_change": {
				"period": "quarterly",
				"min_change": 10
			}
		},
		"company_headcount_range": ["51-100", "101-200", "201-500"]
	},
	"page": 1
}

Find Similar Companies with ICP and News Signals


{
	"filters": {
		"company_lookalike": {
			"domain": "hubspot.com",
			"minimum_tier": "T2"
		},
		"company_icp": {
			"company_sizes": ["smb", "midmarket"],
			"departments": {
				"include": ["Sales", "Marketing"],
				"match_mode": "any"
			}
		},
		"company_news": {
			"categories": ["Funding & Investment", "Product Launch"],
			"timeframe_days": 180
		}
	},
	"page": 1
}

Search Filters Documentation

Enum Values

Quick Reference

Person Filters

Company Filters

Global Constraints

Person Filters

person_search

person_name

person_name_or_job_title

person_job_title

Standard Mode

Boolean Search Mode

Boolean Search Syntax

person_department

person_seniority

person_location_search

person_contact_details

max_person_per_company

person_year_of_experience

person_time_in_current_role

person_time_in_current_company

person_job_change

person_education

person_awards_certifications

person_past_job_title

person_past_company

Company Filters

company

company_location_search

company_headcount_range

company_headcount_custom

company_industry

company_keywords

company_attributes

company_naics

company_sics

company_revenue

company_type

company_funding

company_technology

company_founded

company_headcount_growth

company_job_posting_hiring_for

Standard Mode

Boolean Search Mode

company_job_posting_quantity

company_headcount_by_department

company_email_provider

company_headcount_by_location

company_news

company_intent

company_key_execs

company_website_traffic

company_key_customers

company_lookalike

Mode A: Company Seeds

Mode B: ICP Text

Mode D: Domain

company_website_search

company_icp

company_google_discovery

company_products_services

company_integrations

company_awards

company_operating_languages

Enum Values Reference

Education Degree Values

Seniority Values

Employee Range Values

Revenue Range Values

Company Type Values

Company Subtype Values

Business Model Values

News Category Values

Executive Event Type Values

ICP Department Values

ICP Company Size Values

Funding Stage Values

Department Values