Documentation / 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, 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 and 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 explains how.

This page explains the operators. For the rules that apply to an entire query, see 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 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, 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.