Through our Advanced Alerts, the Boolean Query enables you to enhance the quality of your results and to monitor more precisely the topics that matter to you.

Advanced Alerts give you the option to use up to 2,000 characters and associate them the way you want to create the perfect query and reduce potential noise.

3 elements are necessary to build the Query:

  1. Keywords related to your topic.
  2. Parentheses, to differentiate your logical groups.
  3. Boolean Operators, to associate them in the right way.

1. Keywords

A keyword can contain only letters, digits and underscore. The first character can also be # or @, if you want to search for hashtags or handles. Keywords are case-insensitive.

If your keyword is made of one plain word, you can write it directly into the query.

If it is composed of more than one word (phrase) or has a special character or number, you will need to enclose it in double quotes.

Here you have the possibility to include more different characters, like accent marks.

The characters " and \ must be preceded by a \.

“I’m a phrase”
“hè||°”
“I’m a \“cool\” example”

Mentions are fetched even if the spaces are longer. For instance, the first example will return mentions containing “I’m a phrase”, but also “I’m a phrase”.

When you are including an url as a phrase, you are also searching for the backlinks:

"nasa.gov"

This one will match also mentions that use this url as a backlink.

2. Parentheses ( )

You have to use the parentheses to separate every group of keywords, in order to use an operator in between.

(oasis OR Nasa) AND rover

3. Boolean Operators

★ AND

When you use AND in between, you will find mentions that contain both keywords or phrases.

nasa AND space

★ OR

When you use OR in between, you will find mentions containing either the first keyword (or phrase) or the second one.

nasa OR "n.a.s.a" OR "Nasa.gov"

❗️You can not mix AND and OR in the same parenthesis group.

★ AND NOT/OR NOT

This operator helps you to exclude mentions from the search. NOT can be used with keywords, phrases, and also needs to be combined with AND or OR.

nasa AND NOT SpaceX

★ Proximity: ~#

This operator will match any mention with the keyword1 and keyword2 separated by up to # words.

You can replace # by numbers between 1 to 6.

"nasa rover"~6

★ NEAR/#

Similar to the Proximity operator but working for both keywords and phrases. So it is used between both keywords or phrases.

You can replace # by numbers between 1 to 6.

"graphic design" NEAR/6 "new york"

❗️NEAR cannot be chained to be used with more than 2 keywords/phrases.

★ url:

This Operator matches mentions that contain the given string in the mention's URL.

url:”nasa.gov”

This example will match mentions from:

  • nasa.gov
  • nasa.gov/space
  • And also spacex.com/exampleURLwith-nasa.gov

The url Operator can not appear alone, needs to be combined with and AND or AND NOT.

★ lang:

If you add this Operator to your Query, you will only monitor the quoted languages. To monitor all languages, just don’t use the operator.

lang:(fr OR en)

It needs to be combined with AND or AND NOT.

👉 Here you can find a list with all the Language codes.

★ title:

By using this one, you will only consider mentions that include the following keyword in the title.

title:nasa

This Operator doesn’t work for Twitter, Facebook, Instagram and Forums. If it is used with one of these Sources, the keyword will be searched like a regular one.

★ source:

You can use this one to define the sources that you want to monitor. If you want to monitor all Sources, just don’t use the Operator.

nasa AND source:(web OR news)

It needs to be combined with AND or AND NOT.

❗️This Operator doesn't work with Historical Data. If you use it, you will see mentions coming from all sources.

★ source_name:

This one will help you find mentions that include a name.

It needs to be combined with AND or AND NOT.

concert AND source_name:justinbieber

❗️This Operator only works for Twitter.

★ source_username:

Thanks to this Operator you can monitor handles.

It needs to be combined with AND or AND NOT.

concert AND NOT source_username:justinbieber

❗️This Operator only works for Twitter.

★ source_country:

It lets you define the location of your mention.

This Operator only works for Web, News, Blogs, Forums and Twitter.

hello AND source_country:(US OR GB)

It needs to be combined with AND or AND NOT.

Here you can find all country codes (ISO 2).

★ NOT has:source_country

This Operator is the same as above except that this time mentions without any location will be included. It can also be written -has:source_country.

hello AND (source_country:(US OR GB) OR NOT has:source_country)

It needs to be combined with AND or AND NOT.

★ influence:XX

With this one, you can monitor mentions with a minimum Influencer Score.

influence:45

It needs to be combined with AND or AND NOT.

❗️This operator can’t be used with value under 40. It works only for Web, News, Blogs, Forums and Twitter.

★ twitter_followers:XXX

This one will match mentions whose Twitter author has at least the given number of followers.

If it is used with another source than Twitter, no mentions will be returned from that source. To avoid that, use OR NOT source:twitter, as in the example below:

nasa AND (twitter_followers:800000 OR NOT source:twitter)

It needs to be combined with AND or AND NOT.

Example of Boolean Query:

👉 Follow our best practices to create Boolean Queries!

Did this answer your question?