Filter DSL

One filter string, GitHub-search-style. AND binds tighter than OR;-x or NOT x for negation; comma-lists scope to one predicate; tag@evidence requires evidence ≥ low/medium/high. Any bareword (an identifier or number not followed by an operator) becomes a free-text keyword search — mix it freely with structured filters: dental industry:marketing_agency.

The kind field is implicit on /v1/datasets/:id/search (URL is authoritative) and using it inside the filter is rejected with HTTP 400. Different datasets surface different field sets — see /v1/datasets/:id or the endpoints page for per-dataset filter lists.

Live tester

Examples · pro_services

• ▸industry:marketing_agency service_provided:seo
• ▸dental industry:marketing_agency— barewords become keyword:<x>
• ▸industry:legal state:CA,NY -company_size_signal:solo
• ▸industry:management_consulting (service_provided:strategy-consulting@high OR service_provided:operations-consulting@high)
• ▸state:CA has:phone has:email
• ▸rating>=4 review_count_total>=20
• ▸has:clutch has:g2

Grammar

filter   := orExpr
orExpr   := andExpr ("OR" andExpr)*
andExpr  := notExpr (("AND")? notExpr)*    # whitespace = implicit AND
notExpr  := ("NOT" | "-") notExpr | atom
atom     := "(" filter ")" | predicate
predicate:= IDENT op valueOrList | bareword
op       := ":" | "=" | ">=" | "<=" | ">" | "<"
valueOrList := value ("," value)*
value    := IDENT | NUMBER | tagAtEvidence
tagAtEvidence := IDENT "@" ("low"|"medium"|"high")
bareword := IDENT | NUMBER          # → keyword:<bareword>

Field catalog