Operator 

Description 

Example 

" " 

Indicates the term(s) must be matched exactly as specified. 

"apple juice" 

This query finds mentions that contain the exact phrase "apple juice". 

AND 

Indicates that matching mentions must include both terms specified. AND must be uppercase. 

apple  AND  juice 

Mentions contain all the terms. This query finds mentions that contain "apple" and "juice" on the same webpage. Mentions with only one of these terms are excluded. 

OR 

Indicates that matching mentions must include at least one of the terms specified. OR must be uppercase. 

apple  OR  juice 

This query finds mentions that contain "apple" or "juice". 

NOT 

Indicates that matching mentions must not include the term specified. NOT must be uppercase. 

apple  NOT  juice 

This query finds mentions of 'apple', as long as ‘juice’ is not mentioned on the same webpage. 

() 

Groups terms together so that a single operator can be applied to everything in the brackets. 

(apple AND juice) OR (apple AND sauce) 

This query finds mentions that contain 'apple' and 'juice' on the same webpage, or mentions that contain 'apple' and 'sauce' on the same webpage. 

{ } 

Indicates that the specified term is case-sensitive, and only works for words with five characters or less. If you specify a word with more than five characters, the query finds mentions with any capital/lower case spelling of the word. Upper-case matching works for words with up to 20 characters.

{BT} 

This query finds mentions where “BT” appears in uppercase (not “bt” or “Bt”). 

Accent 

Queries with non-accented terms match on accented and non-accented spelling of the specified term. To exclude specific accented words, use the NOT operator (for example, Nino NOT Niño). 

“niño” 

This query finds mentions that contain the accented spelling of the word "niño" (but not, for example, nino). 

<<<>>> 

Indicates the text inside the angle brackets is not part of the search query (for example, a comment after a section of the query). 

<<< End of section >>> 

This query ignores the text inside the angle brackets. 

Operator 

Description 

Example 

continent: 

Indicates that mentions are restricted to those from a specific continent. continent: must be lowercase. 

continent:"EUROPE" AND "apple juice" 

This query finds mentions of "apple juice" that have been identified as originating from Europe. 

country: 

Indicates that mentions are restricted to those from a specific country. country: must be lowercase. View a list of country codes here!

country:"GBR" AND "apple juice" 

This query finds mentions of 'apple juice' that have been identified as originating from the UK. 

region: 

Indicates that mentions are restricted to those from a specific region. You can use the region operator to specify a state, region, or province. region: must be lowercase. Put quotation marks around the region.

region:"USA.FL" AND “apple juice” 

This query finds mentions of 'apple juice' that have been identified as originating from Florida. 

city: 

Indicates that mentions are restricted to those from a specific city. city: must be lowercase. Put quotation marks around the country, state and city.

city:"GBR.Greater London.London" AND "apple juice" 

This query finds mentions of 'apple juice' that have been identified as originating from London. 

latitude: 

longitude 

Indicates that mentions are restricted to those coming from specific coordinates. You can use the latitude: and longitude: operators alone or in combination with each other. 

latitude:[41 TO 44] AND longitude:[-73 TO -69] 

This query finds mentions that have been identified as originating from the geographic area corresponding to the specified latitude and longitude coordinates. 

site: 

Indicates that mentions are restricted to those from a specific website. You can also use the site: operator with the NOT operator to exclude mentions from a specific site. 

When you specify the site, you must include the top-level domain (for example, .com or .co.uk). Do not include “www” before the domain name. 

The site: operator searches the top level of a domain. Use the url: operator to search for mentions in a particular part of a site. Use the links: operator to search for any part of a website.

site:twitter.com AND "apple juice" 

This query finds mentions of “apple juice” on Twitter. 

url: 

Indicates that mentions are restricted to those from a specific page on a site. Use quotation marks to match the exact section of a URL. 

url:"msn.com/news" AND "Simon Cowell" 

This query finds mentions of 'Simon Cowell' on the news section of the MSN website. 

title: 

Indicates that mentions are restricted to those from sites with the specified term(s) in the webpage title. 

You can use the title: operator with the NOT operator to exclude mentions from pages with a specific word in the title. 

To lock in case-sensitivity with this operator, nest the term between brackets { }. Upper-case matching works for words with up to 20 characters.

title:"apple juice" 

This query finds mentions where “apple juice” appears in the webpage title. 

title: {"Apple juice"}

This query finds only those mentions where the "A" in "Apple juice" is capitalized, not "apple Juice", or "apple juice".

author: 

Indicates that mentions are restricted to those from a specific author. The operator matches exact spelling only. 

author:justinbieber 

This query finds mentions by any author named justinbieber. This operator matches exact author names only (for example, justinbieber95 would not be matched). This example would find mentions from his Twitter account (Twitter handle = @justinbieber), but not his YouTube channel (YouTube name = Justin Bieber).

author:"Justin Bieber"

This query finds mentions by any author named Justin Bieber and will match exact author names only. This example would not find Twitter mentions (Twitter handle = @justinbieber), but it would display mentions from his YouTube channel (YouTube author name = Justin Bieber).

language:zh 

This query finds mentions only in Chinese as “zh” is the 639-1 language code for Chinese.