Pre-Black Friday: 20% off, for as long as you stayEARLYBFon Solo and AgencyEnds Nov 28Start free

Documentation

Filter reference

60 filters for people search and 40 for company search, with their types and allowed values. This page is read from the running API, so it cannot drift from what the endpoint accepts.

How filters combine

Filters join with AND; several values inside one filter join with OR. So seniority=vp,c_suite&country=US means a VP or C-level person, in the United States.

Array filters are comma-separated in a query string and JSON arrays in a POST body. Keyword filters match on substrings — wrap a value in [brackets] for an exact match. Every exclude… filter removes matches from the filter it names.

Enum filters accept only the values in the catalogue; anything else is a 400 naming the field. GET /v1/filters is public and returns this whole structure as JSON, which is what to generate queries from rather than hard-coding a list.

People filters

Accepted by GET /v1/people/search.

FilterTypeGroupValues and notes
qstringPersonfree text over the person: name, title, headline, profile summary, skills, job descriptions, and their company name
profileKeywordsstring[]Personthe same as keywords — the person’s own profile text; kept under this name for clients that adopted it
excludeProfileKeywordsstring[]Personprofile keywords to exclude
titlestring[]Personjob title keywords; wrap a value in [brackets] for an exact match
excludeTitlestring[]Personjob titles to exclude
excludeViewedbooleanPersonleave out the people this account marked viewed (POST /v1/people/viewed) in viewedSet; exact for a list up to 20,000, a skip-ahead walk beyond (see meta.excludedViewed, meta.walkCapped)
viewedSetstringPersonwhich viewed list excludeViewed reads, e.g. one per end-client workspace; default "default"
excludeIdsstring[] ≤ 1000Personperson_ids to leave out of the results, e.g. ones you already showed; max 1,000
seniorityenum[]Personowner · founder · c_suite · partner · vp · head · director · manager · senior · entry · intern · unknown
LeadOcean seniority band (mapped onto job_level upstream) — LeadOcean seniority band, normalised across sources.
jobLevelenum[]PersonC-Team · Director · Manager · Other · Staff · VP
seniority band as the data source defines it — Seniority band of the person's current role.
jobFunctionenum[]PersonAdvertising & Marketing · Art, Culture and Creative Professionals · Construction · Customer/Client Service · Education · Engineering · Finance & Accounting · General Business & Management · Healthcare & Human Services · Human Resources · Information Technology · Legal · Manufacturing & Production · Operations · Other · Public Administration & Safety · Purchasing · Research & Development · Sales & Business Development · Science · Supply Chain & Logistics · Writing/Editing
department or function of the current role — Department or function of the person's current role.
countryenum[]Person location254 values · country
where the person is located — ISO 3166-1 alpha-2 country code, plus XK for Kosovo. Labels give the English country name.
continentenum[]Person locationAfrica · Antarctica · Asia · Europe · North America · Oceania · South America
continent the person is in — Continent of the person or the company headquarters.
salesRegionenum[]Person locationNORAM · LATAM · EMEA · APAC
commercial region the person is in — Commercial region of the person or the company headquarters.
citystring[]Person locationcity keywords for the person
excludeCitystring[]Person locationcities to exclude
educationstring[]Personschool, degree or year phrases
minConnectionsintPersonminimum LinkedIn connections, 0–500 — 0 means no minimum; any value of 1 or more matches only records whose figure we hold
domainstring[]Companycompany domain the person works at
companyNamestring[]Companycompany name phrase (all words, adjacent); wrap a value in [brackets] for an exact name match
excludeCompanyNamestring[]Companycompany name phrases to exclude; [brackets] for exact
companyLinkedinstring[]Companycompany LinkedIn URLs
industryenum[]Company534 values · industry
company industry — Company industry. One of 534 normalised values.
excludeIndustryenum[]Company534 values · industry
industries to exclude — Company industry. One of 534 normalised values.
companyTypeenum[]CompanyEducational · Educational Institution · Government Agency · Nonprofit · Partnership · Privately Held · Public Company · Self-Employed · Self-Owned · Sole Proprietorship
legal type of the company — Legal/organisational type of the company.
employeeRangeenum[]Size and revenue1-10 · 11-50 · 51-200 · 201-500 · 501-1000 · 1001-5000 · 5001-10000 · 10001+
headcount bracket; coarser and faster than minEmployees/maxEmployees — Company headcount bracket.
minEmployeesintSize and revenuecompany headcount, lower bound — only records whose value we hold; one with no figure on file is never returned
maxEmployeesintSize and revenuecompany headcount, upper bound — only records whose value we hold; one with no figure on file is never returned
minFoundedintSize and revenueyear the company was founded — only records whose value we hold; one with no figure on file is never returned
maxFoundedintSize and revenuelatest year the company was founded — only records whose value we hold; one with no figure on file is never returned
minFollowersintSize and revenueminimum company LinkedIn followers — 0 means no minimum; any value of 1 or more matches only records whose figure we hold — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
fundingTypeenum[]FundingSeries unknown · Pre seed · Seed · Series A · Series B · Series C · Series D · Series E-J · Grant · Angel · Private equity · Debt financing · Non equity assistance · Post IPO equity · Undisclosed · Post IPO debt · Product crowdfunding · Equity crowdfunding · Corporate round · Convertible note · Secondary market · Initial coin offering · Post IPO secondary
type of the last funding round — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters — Type of the most recent funding round.
minFundingintFundingtotal funding raised, USD — only records whose value we hold; one with no figure on file is never returned — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
maxFundingintFundingtotal funding raised, USD ceiling — only records whose value we hold; one with no figure on file is never returned — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
minLastFundingYearintFundingfunded no earlier than this year — only records whose value we hold; one with no figure on file is never returned — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
maxLastFundingYearintFundingfunded no later than this year — only records whose value we hold; one with no figure on file is never returned — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
investorsstring[]Fundinglead investor keywords — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
sicstring[]CompanySIC codes of the employer — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
naicsSectorenum[]Company11 · 21 · 22 · 23 · 31 · 42 · 44 · 48 · 51 · 52 · 53 · 54 · 55 · 56 · 61 · 62 · 71 · 72 · 81 · 92 · 99
two-digit NAICS sector of the employer as STORED on the person record (a SIC crosswalk from the source): the first-listed sector, held for about half of people, as of the last people build — applies directly, never dropped. It can differ from the company record’s derived company_data.naics_sector — Two-digit NAICS sector. Ranges collapsed onto their first value as the data spells them (31–33 → 31, 44–45 → 44, 48–49 → 48). On a PEOPLE search it is the employer's first-listed sector, held for about half of people as of the last people build; on companies it is derived from naics_primary. '99' is the source's "unclassified" marker, kept by decision (2026-10-03) so companies and people carrying it can be filtered and counted.
keywordsstring[]Personkeywords in the person’s own profile: headline, summary, skills and job descriptions — the PERSON’s text, not the employer’s (for the company’s text search companies, or filter people by industry / companyName). Each value is a phrase whose words must all appear; several values OR together
excludeKeywordsstring[]Personprofile keywords to exclude
companyKeywordsstring[]Companywhat the EMPLOYER does, in its own words: each value is a phrase whose words must all appear in the company’s description, specialties, tags or name — or an exact industry label, which then matches every company filed under it; several values OR together. The broad way to ask for "people at cybersecurity companies": an industry label alone misses most of them — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
hqCountryenum[]Headquarters254 values · country
company headquarters country — ISO 3166-1 alpha-2 country code, plus XK for Kosovo. Labels give the English country name.
hqCitystring[]Headquarterscompany headquarters city keywords — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
hqStatestring[]Headquarterscompany headquarters state or region — a US state, Canadian province, Australian state or German Land also matches its other spellings ("TX" finds "Texas", "Bayern" finds "Bavaria"), at companies in that country only; add hqCountry to pin an ambiguous code such as WA — matched through the employer: applies when the matching companies (after the HQ, size, industry and company-type filters) number 50,000 or fewer, otherwise named in unsupportedFilters
hqContinentenum[]HeadquartersAfrica · Antarctica · Asia · Europe · North America · Oceania · South America
continent of the company headquarters — Continent of the person or the company headquarters.
hqSalesRegionenum[]HeadquartersNORAM · LATAM · EMEA · APAC
commercial region of the company headquarters — Commercial region of the person or the company headquarters.
technologiesstring[]Companytechnologies detected on the company website (own data only)
technologyCategoriesenum[]Company105 values · tech_category
what the detected technology is for, e.g. Analytics or CDN, rather than its name (own data only; covers the ~7.8M crawled companies) — What a detected technology is FOR, rather than its name: ask for Analytics instead of naming Google Analytics, Matomo and Plausible one by one. Detected from the company's own website, so it covers the 7,843,598 companies we have crawled - about an eighth of the corpus - and a category filter searches that eighth rather than all 63,569,167. Counts are from the 2026-09-07 crawl; web enrichment has not run since, and sites change stacks, so treat this as a recent snapshot.
emailStatusenum[]Contactverified · catch_all_valid · catch_all · risky · unknown · untested · invalid · role · disposable · spam_trap · abuse · derived · none
email deliverability (own data only) — Deliverability of the person's best email, from verification rather than a guess. On a BUSINESS address (`work`, `work_other`, `other`), `verified` means OUR OWN verifier sent to the address and it accepted — nothing else earns the word, and a data supplier asserting that an address is good is not a check, whichever supplier it is: those are published as `untested`. PERSONAL ADDRESSES ARE THE EXCEPTION and the difference is worth knowing: we do not verify consumer domains at all, so on a personal address `verified` still means a supplier asserted it and you should treat it as a lead to verify rather than a confirmed one. The dedicated personal-email endpoint publishes no status for that reason. `catch_all` means WE probed the domain, on the same rule and with the same personal-address exception. In practice that changes nothing for catch_all — a catch-all verdict can only come from probing the domain, which no supplier does — so the whole of the current catch_all population already qualifies. This narrowed on 2026-09-20 and again on 2026-09-22, so a `verified` count taken before either date is not comparable with one taken after — the population is smaller each time and every address in it has been tested by us. ONE INCONSISTENCY WHILE THIS ROLLS OUT: enrichment (/v1/people/enrich, the v2 contact endpoints, MCP) applies the narrow rule per address; people search does not, because the search index carries no per-address verification provenance. A person can come back `verified` in a search row and `untested` when enriched, and the enriched answer is the correct one. Treat a search count of `verified` as an upper bound and confirm per address on enrichment. Safe to send: verified, and catch_all_valid — a mailbox on a catch-all domain whose EXISTENCE we confirmed through the provider's identity check (Microsoft 365 managed tenants and Google Workspace only; the domain would accept any address, this one is known to be real). It ranks between verified and catch_all and is earned only by that check, never by a supplier and never by re-reading an older catch_all verdict. As a FILTER, `catch_all` matches both catch_all and catch_all_valid (a confirmed mailbox is still on a catch-all domain), so an existing verified+catch_all filter keeps the promoted people; filter on `catch_all_valid` alone for the narrow set. Cannot be confirmed either way, because the domain accepts everything: catch_all. Do not send: invalid, spam_trap, abuse, disposable. Use with care: risky, role (a shared mailbox like info@) and derived (built from the company's address pattern and never tested). untested means nobody has checked this address yet — it may well be fine, and it is the largest group; unknown means it WAS checked and the result was inconclusive, which is a weaker signal than untested, not a stronger one. none means the person has no email.
emailTypeenum[]Contactwork · work_other · work_any · personal · other · unknown · none
work or personal email (own data only) — Kind of the person's best email address. work is at their CURRENT employer's domain. work_other is a business address at a different company — usually a former employer, so it is the one most likely to bounce or to reach whoever inherited the mailbox; ask for it deliberately, not by accident. work_any is the union of the two. personal is webmail and similar; other is a business address where we do not know the employer; unknown means the address exists but we cannot classify it, which is the most common answer; none means the person has no email. Pair it with emailStatus to ask for a deliverable address at the company they actually work for.
hasEmailbooleanContactonly people with, or without, a known email (own data only)
hasPhonebooleanContactonly people with, or without, a known phone number (own data only)
reachableenumContactany · strict
holding an email OR a phone — `strict` additionally requires the email to be verified, catch_all_valid or catch_all — How a person can be reached at all. any = we hold an email or a phone. strict = we hold a phone, or an email that is verified or on a catch-all domain — i.e. excluding addresses we know are bad and addresses nobody has checked yet.
cursorstringOptionsopaque, from meta.nextCursor
limitint ≤ 100 · default 25Optionsrecords per page, 1–100 (an account enabled for unlimited walks may ask up to 200 on order=stable)
facetsbooleanOptionsalso return counts by seniority, country, industry and company size
facetCompaniesbooleanOptionsalso count distinct employers inside each facet bucket (an estimate within ~1%); slower on a wide filter, so off by default — meta.distinctCompanies at the top level comes with every filtered count (null with no filter at all)
slimbooleanOptionsdrop empty and heavy parts of each record (picture block, duplicate lists); default false over REST, true over MCP
fieldsstring[]Optionsdotted paths to keep, e.g. profile_data.profile_full_name,meta.source_ids; everything else is omitted

Company filters

Accepted by GET /v1/companies/search.

FilterTypeGroupValues and notes
qstringCompanyfree text over company name and description
namestring[]Companycompany name phrase (all words, adjacent); wrap a value in [brackets] for an exact name match
excludeNamestring[]Companycompany name phrases to exclude; [brackets] for exact
domainstring[]Companycompany website domains
linkedinstring[]Companycompany LinkedIn URLs — resolved through the people we hold at the company (most real companies); a URL nobody works at is a 404 pointing at GET /v1/companies/enrich?linkedin_url=…, which always works
industryenum[]Company534 values · industry
company industry — Company industry. One of 534 normalised values.
excludeIndustryenum[]Company534 values · industry
industries to exclude — Company industry. One of 534 normalised values.
companyTypeenum[]CompanyEducational · Educational Institution · Government Agency · Nonprofit · Partnership · Privately Held · Public Company · Self-Employed · Self-Owned · Sole Proprietorship
legal type of the company — Legal/organisational type of the company.
employeeRangeenum[]Size and revenue1-10 · 11-50 · 51-200 · 201-500 · 501-1000 · 1001-5000 · 5001-10000 · 10001+
headcount bracket — broader and cheaper than min/maxEmployees — Company headcount bracket.
minEmployeesintSize and revenuecompany headcount, lower bound — only records whose value we hold; one with no figure on file is never returned
maxEmployeesintSize and revenuecompany headcount, upper bound — only records whose value we hold; one with no figure on file is never returned
minRevenueintSize and revenueannual revenue floor in USD — only records whose value we hold; one with no figure on file is never returned
maxRevenueintSize and revenueannual revenue ceiling in USD — only records whose value we hold; one with no figure on file is never returned
minFollowersintSize and revenueminimum company LinkedIn followers — 0 means no minimum; any value of 1 or more matches only records whose figure we hold
minFoundedintSize and revenueearliest year the company was founded — only records whose value we hold; one with no figure on file is never returned
maxFoundedintSize and revenuelatest year the company was founded — only records whose value we hold; one with no figure on file is never returned
fundingTypeenum[]FundingSeries unknown · Pre seed · Seed · Series A · Series B · Series C · Series D · Series E-J · Grant · Angel · Private equity · Debt financing · Non equity assistance · Post IPO equity · Undisclosed · Post IPO debt · Product crowdfunding · Equity crowdfunding · Corporate round · Convertible note · Secondary market · Initial coin offering · Post IPO secondary
type of the most recent funding round — Type of the most recent funding round.
minFundingintFundingtotal funding raised, USD floor — only records whose value we hold; one with no figure on file is never returned
maxFundingintFundingtotal funding raised, USD ceiling — only records whose value we hold; one with no figure on file is never returned
minLastFundingYearintFundingfunded no earlier than this year — only records whose value we hold; one with no figure on file is never returned
maxLastFundingYearintFundingfunded no later than this year — only records whose value we hold; one with no figure on file is never returned
investorsstring[]Fundinglead investor name keywords
naicsstring[]CompanyNAICS industry codes — any code the company carries
naicsPrimarystring[]Companythe ONE NAICS code a company is filed under (company_data.naics_primary); narrower than naics, which matches any listed code
naicsSectorenum[]Company11 · 21 · 22 · 23 · 31 · 42 · 44 · 48 · 51 · 52 · 53 · 54 · 55 · 56 · 61 · 62 · 71 · 72 · 81 · 92 · 99
two-digit NAICS sector, DERIVED from the industry label and the codes — the same value the record shows as company_data.naics_sector, so a filtered company always displays the sector it was filtered by. 18 values held; the coarse grouping for sizing — Two-digit NAICS sector. Ranges collapsed onto their first value as the data spells them (31–33 → 31, 44–45 → 44, 48–49 → 48). On a PEOPLE search it is the employer's first-listed sector, held for about half of people as of the last people build; on companies it is derived from naics_primary. '99' is the source's "unclassified" marker, kept by decision (2026-10-03) so companies and people carrying it can be filtered and counted.
sicstring[]CompanySIC industry codes
keywordsstring[]Companykeywords across company description, specialties, tags and name: each value is a phrase whose words must all appear — or an exact industry label, which then matches every company filed under it; several values OR together
excludeKeywordsstring[]Companycompany keywords (or exact industry labels) to exclude
hqCountryenum[]Headquarters254 values · country
company headquarters country — ISO 3166-1 alpha-2 country code, plus XK for Kosovo. Labels give the English country name.
hqCitystring[]Headquarterscompany headquarters city keywords
hqStatestring[]Headquarterscompany headquarters state or region — a US state, Canadian province, Australian state or German Land also matches its other spellings ("TX" finds "Texas", "Bayern" finds "Bavaria"), at companies in that country only; add hqCountry to pin an ambiguous code such as WA
hqContinentenum[]HeadquartersAfrica · Antarctica · Asia · Europe · North America · Oceania · South America
continent of the company headquarters — Continent of the person or the company headquarters.
hqSalesRegionenum[]HeadquartersNORAM · LATAM · EMEA · APAC
commercial region of the company headquarters — Commercial region of the person or the company headquarters.
technologiesstring[]Companydetected technologies (own data only)
technologyCategoriesenum[]Company105 values · tech_category
what the detected technology is for, e.g. Analytics or CDN, rather than its name (own data only; covers the ~7.8M crawled companies) — What a detected technology is FOR, rather than its name: ask for Analytics instead of naming Google Analytics, Matomo and Plausible one by one. Detected from the company's own website, so it covers the 7,843,598 companies we have crawled - about an eighth of the corpus - and a category filter searches that eighth rather than all 63,569,167. Counts are from the 2026-09-07 crawl; web enrichment has not run since, and sites change stacks, so treat this as a recent snapshot.
hasMailableContactsbooleanContactstrue = companies with at least one person whose best email is verified, catch_all_valid or catch_all; false = companies with none (LeadOcean data only)
cursorstringOptionsopaque, from meta.nextCursor
limitint ≤ 100 · default 25Optionsrecords per page, 1–100 (an account enabled for unlimited walks may ask up to 200 on order=stable)
slimbooleanOptionsdrop the technology list (the count stays), tags, specialties, financials and every empty field; default false over REST, true over MCP
fieldsstring[]Optionsdotted paths to keep, e.g. company_data.company_name,company_data.company_domain; everything else is omitted

Enum values

Sets small enough to read are printed in the tables above. The large ones live behind their own endpoint, which is public and searchable: GET /v1/enums/<name>?q= returns matching values, so you can offer a type-ahead rather than shipping 534 industries in your bundle.

EnumValuesUsed by
industry534 · fetchindustry, excludeIndustry
company_type10 · listed abovecompanyType
employee_range8 · listed aboveemployeeRange
funding_type23 · listed abovefundingType
job_function22 · listed abovejobFunction
job_level6 · listed abovejobLevel
continent7 · listed abovecontinent, hqContinent
sales_region4 · listed abovesalesRegion, hqSalesRegion
country254 · fetchcountry, hqCountry
seniority12 · listed aboveseniority
email_type7 · listed aboveemailType
reachable2 · listed abovereachable
email_status13 · listed aboveemailStatus
tech_category105 · fetch
naics_sector21 · listed abovenaicsSector

Every value at once is also in openapi.json and llms-full.txt.