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_queryandbody_queryof the search tools, for examplenews_searchandprospects_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, andMAYBEare operators only in capital letters. In lower case, each one is a plain word: "maybe" is a word, andMAYBEis an operator.NEARandNOTNEARwithout a/are plain words too:hotels NEAR mesearches 3 words.- An operator between 2 words (
AND,OR,MAYBE,NEAR/N, andNOTNEAR/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~Ndirectly after it, with no space. - N is a whole number from 1 to 100 in
^N,~N,NEAR/N, andNOTNEAR/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, andNOTNEARare 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, andhotel ~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, andhotel +spafind 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, andhotel 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 ofAND, or remove it.hotel + spaandhotel +: "a + must be directly before a word. Remove the + or the space after it." Typehotel +spaorhotel spa.++hoteland+-"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 motelfinds 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, andhotels 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 ofOR, or typeor.hotel OR -spa: "a word with - before it next to OR, MAYBE, NEAR, or NOTNEAR. Remove the - or the operator." The same error comes forMAYBE,NEAR/N, andNOTNEAR/N. Typehotel -spa, or remove the-.
MAYBE operator
Type MAYBE in capital letters between 2 words.
hotel MAYBE spafinds 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 MAYBEandMAYBE 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 -motelfinds 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, andhotel -(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." TypeBest Hotels 2026 Guide,Hotels, orhotel -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." TypeHotels.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 -."-spaand-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"^10and(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"~5finds 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 spafinds 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, andhotel 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." Typehotel NEAR/3 spa.hotel NEAR/3andNEAR/3 spa: "NEAR/3 needs a word on each side. To search for the word, type it in lower case."NEARwith no/is a plain word:hotels NEAR mesearches the 3 words.
NOTNEAR operator
Type NOTNEAR/ and a number, in capital letters, between 2
words or phrases.
hotel NOTNEAR/3 spafinds 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 spaandhotel NOTNEAR/ spa: "NOTNEAR/ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Typehotel 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.
=hotelsfinds 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 = spaandhotel =: "a = must be directly before a word. Remove the = or the space after it." Typehotel =spa.==aand=-"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=bis refused.
IDF boost modifier
Type ^ and a number after a word.
hotel spa^2finds the same pages ashotel 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, andcar^2^3: "^ needs a whole number from 1 to 100 directly after it, and then a space or the end of the query." Typecar^2.hotel ^10andhotel ^ spa: "^10 must be directly after a letter or a digit." The error names the^Nthat 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 *." Typehotel*.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." Typehotel*.=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) spafinds 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:
^wordandword$ - 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.