<!-- The markdown copy of https://oppalerts.com/docs/the-data/advanced-search-operators . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [The Data](https://oppalerts.com/docs/the-data/) / Advanced Search Operators

# Advanced Search Operators

Narrow or broaden word searches with operators for required words, alternatives, phrases, and more.

## Where operators apply

An operator is a word or character that controls how a search works. It is not searched as a word itself. Use operators in Title query and Body query:

- In the web app: [Advanced Search](https://oppalerts.com/docs/app/opportunities/advanced_search), the type pages, the brand pages, and a saved opportunity.
- In the API and MCP tools: the fields `title_query` and `body_query` of the search tools, for example [`news_search`](https://oppalerts.com/docs/mcp/news_search) and [`prospects_search`](https://oppalerts.com/docs/mcp/prospects_search).

The name of each operator on this page is its name in the Manticore Search manual.

An organization's brand name is not a query. Brand searches match it as an exact phrase. [How Terms Are Matched](https://oppalerts.com/docs/the-data/how-terms-are-matched) explains how.

This page explains the operators. For the rules that apply to an entire query, see [How to Search the Indexes](https://oppalerts.com/docs/the-data/how-to-search-the-indexes): allowed characters (English only), how the index reads a word, and the 2 changes that OppAlerts makes to a query. OppAlerts does not correct a query.

## The rules

- `OR`, `AND`, `NEAR`, `NOTNEAR`, and `MAYBE` are operators only in capital letters. In lower case, each one is a plain word: "maybe" is a word, and `MAYBE` is an operator. `NEAR` and `NOTNEAR` without a `/` are plain words too: `hotels NEAR me` searches 3 words.
- An operator between 2 words (`AND`, `OR`, `MAYBE`, `NEAR/N`, and `NOTNEAR/N`) needs a word, a phrase, or a group in parentheses on each side.
- Type `-`, `+`, and `=` directly before the word or the phrase, with no space. Type `*`, `^N`, and `~N` directly after it, with no space.
- N is a whole number from 1 to 100 in `^N`, `~N`, `NEAR/N`, and `NOTNEAR/N`.
- A character that is not a letter a to z, a digit, white space, a `-`, `_`, or `@` inside a word, or an operator of this page is refused. [The characters of a query](https://oppalerts.com/docs/the-data/how-to-search-the-indexes#characters) tells more.
- Inside a phrase, `OR`, `AND`, `MAYBE`, `NEAR`, and `NOTNEAR` are plain words. A character that is not allowed is refused inside a phrase too.
- A Title query or a Body query can have at most 20 words or phrases. A query with more than 20 is refused, and the error names the field.

## A query with a formatting error

OppAlerts does not correct queries. It rejects a query if it contains an unsupported character or uses an operator incorrectly. The query is neither searched nor saved. The page or tool shows a sentence naming the box or field, stating "has a formatting error", explaining the error, and telling you how to correct it. Correct the query, then search or save again. Examples of unsupported characters appear on [How to Search the Indexes](https://oppalerts.com/docs/the-data/how-to-search-the-indexes#refused-characters), with an accepted form for each example.

An operator used in an invalid position causes a formatting error. Each query below is rejected:

- `"day spa"^x`, `@hotel^3`, and `hotel
 ~x`
- `*hotel`, `#hotel*`, and `$100*`
- `+"..." hotel`

- On a search page: "Not searched. The Title query box has a formatting error: OR needs a word on each side. To search for the word, type it in lower case."
- In the API and MCP tools: "title_query has a formatting error: OR needs a word on each side. To search for the word, type it in lower case."
- When you save an opportunity of a campaign: "Not saved. The Title query box has a formatting error: OR needs a word on each side. To search for the word, type it in lower case."

A query with a `"` and no second `"` (`"day spa hotel`, `27" monitor`) is refused: "a " with no second ". Add the second " or remove the "."

Each section below shows incorrect uses of an operator, the message following "has a formatting error:", and the correct form.

## AND operator

Type a space between words, or `AND` in capital letters, or a `+` before a word.

- `hotel spa`, `hotel AND spa`, and `hotel +spa` find the pages that have the word "hotel" and the word "spa".

Every word is required. In the Manticore manual, the AND operator is a space. OppAlerts also accepts `AND` and `+`. Both mean the same as a space.

Wrong uses:

- `hotel AND`, `AND hotel`, and `hotel AND OR
 spa`: "AND needs a word on each side. To search for the word, type it in lower case." Type a word on each side of `AND`, or remove it.
- `hotel + spa` and `hotel +`: "a + must be directly before a word. Remove the + or the space after it." Type `hotel +spa` or `hotel spa`.
- `++hotel` and `+-"day spa"`: "a + must be directly before a letter, a digit, or the opening quote of a phrase, as in +hotel or +"day spa"." Type `+hotel`.
- A `+` inside a word or at the end of a word is a formatting error: `C++` is refused.

## OR operator

Type `OR` in capital letters between 2 words or phrases.

- `hotel OR motel` finds the pages that have "hotel", "motel", or both words.

A page must match at least one of the 2 sides. The manual writes the OR operator as `|`. OppAlerts uses the word `OR`. A query with a `|` is refused.

Wrong uses:

- `hotel OR`, `OR hotel`, `hotel OR OR
 spa`, `(OR hotel) spa`, and `hotels in Portland
 OR`: "OR needs a word on each side. To search for the word, type it in lower case." Type a word or a phrase on each side of `OR`, or type `or`.
- `hotel OR -spa`: "a word with - before it next to OR, MAYBE, NEAR, or NOTNEAR. Remove the - or the operator." The same error comes for `MAYBE`, `NEAR/N`, and `NOTNEAR/N`. Type `hotel -spa`, or remove the `-`.

## MAYBE operator

Type `MAYBE` in capital letters between 2 words.

- `hotel MAYBE spa` finds the pages that have "hotel". The pages may have "spa" or not.

The left side is required. The right side is optional.

Wrong uses:

- `hotel MAYBE` and `MAYBE hotel`: "MAYBE needs a word on each side. To search for the word, type it in lower case."

## Negation operator

Type `-` directly before a word or a phrase, with no space.

- `hotel -motel` finds the pages that have "hotel" and do not have "motel".
- `hotel -"day spa"` finds the pages that have "hotel" and do not have the phrase "day spa".

The negation operator excludes pages containing the word. Only the `-` form is an operator.

The operator `-` must have a space or the start of the query before it, and a letter, a digit, or the opening quote of a phrase directly after it. A `-` between 2 letters or digits is a part of the word, not the operator: `E-trade` finds the word "E-trade".

Wrong uses:

- `Best Hotels - 2026 Guide`, `--spa`, `-=hotel`, and `hotel -(spa)`: "a - needs a letter, a digit, or a phrase in quotes directly after it, as in -spa or -"day spa". Remove the -, or correct the character after it." Type `Best Hotels 2026 Guide`, `Hotels`, or `hotel -spa`.
- `Hotels-`: "a - must have a letter or a digit directly before it and directly after it, as in coca-cola. Remove the -, or type a space in its place." Type `Hotels`.
- `a-"b c"`: "a - must have a space before it, as in hotel -spa or hotel -"day spa". Type a space before the -, or remove the -."
- `-spa` and `-spa -pool`: "only words with - before them. Add a word without -, also inside each pair of parentheses." A query needs at least one word that is not removed: `hotel -spa`.

## Phrase search operator

Put words in double quotes.

- `"boutique hotel"` finds the pages that have the 2 words next to each other, in this order.

The phrase search operator finds the exact phrase. A curly quote is read as a straight quote.

Wrong uses:

- `"day spa hotel`: "a " with no second ". Add the second " or remove the "." Type `"day spa" hotel`.
- `"hotel spa"*`: "a * that is not directly after 3 or more letters or digits. Type at least 3 letters or digits directly before the *."
- `"hotel spa"^10` and `(hotel spa)^10`: "^10 must be directly after a letter or a digit."

## Proximity search operator

Put words in double quotes, then `~` and a number.

- `"hotel spa"~5` finds the pages that have "hotel" and "spa" within 5 words of each other.

All the words of the phrase must be within that number of words of each other. Word order does not matter.

Type `~` directly after the closing quote, with no space. `hotel -"day spa"~5` is accepted.

Wrong uses:

- `"hotel spa"~x`, `"hotel spa"~`, `"hotel spa"~0`, and `"hotel spa"~101`: "~ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Type `"hotel spa"~5`.
- `hotel~3`, `hotel ~3`, `"hotel spa"
 ~3`, `(hotel spa)~3`, and `~50 hotels`: "~3 must be directly after the closing quote of a phrase." Type `"hotel spa"~3`.
- `="hotel spa"~3`: "= and ~3 cannot be on the same phrase." Type `="hotel spa"` or `"hotel spa"~3`.

## NEAR operator

Type `NEAR/` and a number, in capital letters, between 2 words or phrases.

- `hotel NEAR/3 spa` finds the pages that have "hotel" and "spa" with at most 3 words between them.

The 2 sides must be at most that number of words apart. The order of the sides does not matter.

Wrong uses:

- `hotel NEAR/x spa`, `hotel NEAR/ spa`, `hotel NEAR/0 spa`, and `hotel NEAR/101 spa`: "NEAR/ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Type `hotel NEAR/3 spa`.
- `hotel NEAR/3` and `NEAR/3 spa`: "NEAR/3 needs a word on each side. To search for the word, type it in lower case."
- `NEAR` with no `/` is a plain word: `hotels NEAR me` searches the 3 words.

## NOTNEAR operator

Type `NOTNEAR/` and a number, in capital letters, between 2 words or phrases.

- `hotel NOTNEAR/3 spa` finds the pages that have "hotel" where "spa" is not within 3 words of it.

The left side is required. The right side must not be within that number of words of the left side.

Wrong uses:

- `hotel NOTNEAR/x spa` and `hotel NOTNEAR/ spa`: "NOTNEAR/ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Type `hotel NOTNEAR/3
 spa`.
- `hotel NOTNEAR/3`: "NOTNEAR/3 needs a word on each side. To search for the word, type it in lower case."

## Exact form modifier

Type `=` before a word.

- `=hotels` finds the word "hotels" only in this exact form.

The exact form modifier does not find the other forms of the word. Type `=` directly before the word or the phrase, with no space: `="boutique hotels"` is accepted.

Wrong uses:

- `hotel = spa` and `hotel =`: "a = must be directly before a word. Remove the = or the space after it." Type `hotel =spa`.
- `==a` and `=-"day spa"`: "a = must be directly before a letter, a digit, or the opening quote of a phrase, as in =hotel or ="day spa"." Type `=hotel`.
- `=hotel*`: "a word with both = before it and * after it. Use = or *, not both."
- `="hotel spa"~3`: "= and ~3 cannot be on the same phrase."
- A `=` inside a word is a formatting error: `a=b` is refused.

## IDF boost modifier

Type `^` and a number after a word.

- `hotel spa^2` finds the same pages as `hotel
 spa`. The word "spa" has more weight when ordering the results.

The IDF boost modifier changes the order of the results. It does not change which pages match.

Type `^` directly after a letter or a digit of the word, then a whole number from 1 to 100, at the end of the word.

Wrong uses:

- `car^x`, `car^`, `car^0`, `car^101`, and `car^2^3`: "^ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Type `car^2`.
- `hotel ^10` and `hotel ^ spa`: "^10 must be directly after a letter or a digit." The error names the `^N` that you typed. Remove the space before the `^`: `hotel^10`.

## Wildcard operators

Type `*` at the end of a word.

- `hotel*` finds "hotel", "hotels", "hotelier", and each other word that starts with "hotel".

The star finds the words that start with these letters. Put the star only at the end of a word, with at least 3 letters or digits directly before it.

Wrong uses:

- `ca*` and `"hotel spa"*`: "a * that is not directly after 3 or more letters or digits. Type at least 3 letters or digits directly before the *." Type `hotel*`.
- `hotel * spa`: "a * must be directly after a word. Remove the * or the space before it."
- `E*TRADE`: "a * must be at the end of a word, as in hotel*. Remove the *, or the characters after it."
- `hotel-*`: "a - must have a letter or a digit directly before it and directly after it, as in coca-cola. Remove the -, or type a space in its place." Type `hotel*`.
- `=hotel*`: "a word with both = before it and * after it. Use = or *, not both."

## Grouping with parentheses

Put a part of the query in parentheses.

- `(hotel OR motel) spa` finds the pages that have "spa" and one of "hotel" or "motel".

Use one level of parentheses only.

Wrong uses:

- `(hotel (spa OR pool))`: "parentheses inside parentheses. Use only one level of ( and )."
- `(hotel OR motel spa`: "a ( with no ) after it. Add the ) or remove the (."
- `hotel OR motel) spa`: "a ) with no ( before it. Add the ( or remove the )."
- `hotel ()`: "parentheses with no word between them. Put a word or a phrase between ( and ), or remove them."
- `hotel (-spa -pool)`: "only words with - before them. Add a word without -, also inside each pair of parentheses."
- `-(spa) hotel`: "a - needs a letter, a digit, or a phrase in quotes directly after it, as in -spa or -"day spa". Remove the -, or correct the character after it." A group cannot have `-`, `+`, or `=` before it.

## Operators that are not available

These operators from the Manticore manual are not available in OppAlerts. Queries containing their operator characters are rejected:

- Quorum matching operator: `"a b c d"/2`
- Strict order operator: `<<`
- Field-start and field-end modifier: `^word` and `word$`
- Field search operator and its forms: `@title`

The SENTENCE, PARAGRAPH, ZONE, ZONESPAN, and REGEX operators are not available either. Their names are searched as plain words.

The wildcards `?` and `%` are not available. A query with `?` or `%` is refused. A `*` at the start of a word is a formatting error too: `*hotel` is refused.

## Related Pages

- [How Terms Are Matched](https://oppalerts.com/docs/the-data/how-terms-are-matched) How the News Index and the Prospect Index split text into words.
- [Advanced Search](https://oppalerts.com/docs/app/opportunities/advanced_search) How to use the Advanced Search page of the OppAlerts web app.
- [news_search](https://oppalerts.com/docs/mcp/news_search) Search the News Index by words, by semantic similarity, or both.
