Documentation

Boolean Search Syntax

Learn how to use boolean operators (AND, OR, NOT) to build precise search queries for the Enrich Layer API.

Several Enrich Layer API parameters accept Boolean Search Syntax for filtering results. This guide covers all supported operators and practical examples.

Operators

AND (&&)

Combines terms so results include all specified keywords.

bananas && apples
text

Returns only results mentioning both "bananas" and "apples".

OR (||)

Retrieves results containing either term (or both).

bananas || apples
text

Captures results with one or both words.

NOT (-)

Excludes specified terms from results.

bananas -apples
text

Returns results mentioning "bananas" while filtering out any that mention "apples".

Exact Phrase (" ")

Wrapping terms in double quotes matches the exact phrase.

"banana bread"
text

Ensures results contain the precise phrase "banana bread", not just "banana" and "bread" separately.

Grouping (( ))

Parentheses group expressions to control evaluation order, similar to math expressions.

(bananas || apples) && bread
text

Finds results about "bread" paired with either "bananas" or "apples".

Wildcard (*)

The asterisk matches partial words (suffix matching).

star*
text

Matches "star", "stars", "start", "startup", etc.

Constraint: Wildcards cannot lead a query. *apple is invalid; use apple* instead.

Practical Examples

Find engineering managers excluding directors:

"engineering manager" -director
text

Multiple role variations

Search for any VP-level title:

("vice president" || VP) && (engineering || technology)
text

Broad keyword with exclusion

"data scientist" -intern -junior
text

Combined logic

(CTO || "chief technology officer") && (startup || "series a")
text

Usage Limits

  • Each search expression is limited to 255 characters
  • Operators are case-insensitive (AND and and both work)
  • Nested parentheses are supported for complex queries

The following API parameters accept Boolean Search Syntax:

EndpointParameterDescription
Person Searchcurrent_role_titleFilter by current job title
Person Searchpast_role_titleFilter by past job title
Company Searchkeyword_booleanSearch by job title keyword
Employee Searchboolean_role_searchFilter employees by title
Job Searchkeyword_booleanFilter jobs by title keyword