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
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_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	—

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	NAICS codes
`company_sics`	IncludeExclude	Filter by SIC codes	SIC codes
`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
`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	—
`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	—
`company_key_customers`	KeyCustomersFilter	Filter by known customers of the company	—
`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
`company_google_discovery`	GoogleDiscoveryFilter	Find companies by SEO keywords they rank for	—
`company_products_services`	ProductsServicesFilter	Filter by products and service tags	—
`company_integrations`	IntegrationsFilter	Filter by integrations mentioned on company website	—
`company_awards`	AwardsFilter	Filter by awards and recognitions	—
`company_operating_languages`	OperatingLanguagesFilter	Filter by languages the company operates in	—

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_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_name": {
		"include": ["John Smith", "Jane Doe"]
	}
}

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


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

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

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 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. All 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. See NAICS codes for valid values.

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. See SIC codes for valid values.

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` array. See Subtype values below
`business_model`	string 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: `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

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. See MX providers for all 107 valid values.

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. Intent topic_ids are managed from your Prospeo dashboard (Intent settings) — they are not enumerable via the public API.

Field	Type	Constraints
`topic_ids`	array of strings	1-30 items. Each must be a topic ID configured 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`


{
	"company_intent": {
		"topic_ids": ["<topic_id_1>", "<topic_id_2>"],
		"active_research": true,
		"in_depth_research": true
	}
}

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.

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
NAICS codes	Extensive list	View all NAICS codes
SIC codes	Extensive list	View all SIC codes
MX providers	107 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

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

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

Headcount Growth Department Values

Other Enum Values

Complete Example Requests

Search People by Job Title, Seniority, and Company

Search People with Boolean Job Title Search