Keyword Filters

How include / exclude keyword search works across BlitzAPI Search endpoints, plus the exact-match bracket syntax.

Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.

.include and .exclude filters are used as keyword search filters. They work as OR filters, and look if each word appears in the search results.

Simple Example

For example, if you want to look for “Director” in the search results, you can use the following filter:

{
  "include": ["Director"],
  "exclude": []
}

[
  "Director",
  "Director of Sales",
  "Director of Marketing",
  "Director of Product",
  ...
]

Advanced Example

  {
    "include": ["Director", "Manager"],
    "exclude": ["Sales", "Marketing", "Product"]
  }

Giving:

[
  "Director of IT",
  "Director of Finance",
  "Engineering Manager",
  "Finance Manager",
  ...
]

This will result in the following search:

Exact Match Syntax

On top of the regular keyword search, you can also use the exact match syntax. Wrap a value in square brackets to switch to exact match: "[CEO]" matches only values whose lowercased, unaccented form equals "ceo".

Value	Behavior	Matches ✅	Does not match ❌	Case sensitive	Accent sensitive
`"CEO"`	Keyword search (default)	`CEO`, `Co ceo`, `ceo Office`	—	No	No
`"[CEO]"`	Exact (case- and accent-insensitive)	`CEO`, `ceo`, `Céo`	`Co ceo`, `CEO Office`	No	No

The bracket syntax works in both include and exclude, and you can mix it in the same array — e.g. ["[CEO]", "Founder"] means exact "ceo" OR keyword "Founder".

Introduction

Getting Started

Core Concepts

Recipes (Use Cases)

Integrations

Appendix

Keyword Filters

Keyword Filters

Exact Match Syntax

​Keyword Filters

​Exact Match Syntax

Keyword Filters

Exact Match Syntax