# X (formerly Twitter)

{% hint style="info" %}
The ***CTRL+F*** command and ***Command+F*** on a Macbook allows you to easily find your operator in the table.
{% endhint %}

{% hint style="success" %}
You can download this page in PDF.
{% endhint %}

### **List of boolean operators:**

| Symbol            | Use                                                                 | Example                                                                                                                                                          |
| ----------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Space             | To associate words, corresponds to the logical "AND".               | <p><em><strong>bank scandal</strong></em><br><em>It focuses on posts that contain these two keywords, regardless of their position within the post.</em><br></p> |
| OR                | To search for one word or another. Corresponds to the logical "OR". | <p><em><strong>scandal OR boycott</strong></em><br><em>It focuses on posts that contain at least one of these two keywords.</em><br></p>                         |
| Sign -            | To exclude a word.                                                  | <p><em><strong>-bank</strong></em><br><em>To avoid fetching posts that contain this word.</em><br></p>                                                           |
| Bracket ()        | To make groups. By default AND (space) has priority over OR (OR).   | <p><em>(scandal OR boycott) bank</em><br><br>(scandal OR boycott) (banks OR bank)<br><br><em>bank scandal -(director OR CEO)</em></p>                            |
| Quotation mark "" | To monitor an exact expression.                                     | "**General company**" instead of **General company** to avoid picking up tweets such as: "the **company** had planned a **general** meeting for this day".       |

Each line is independent (a new line is the equivalent of an OR with brackets around the line).

{% hint style="danger" %}
There is no need to put the different variants with and without capital letters: Visibrain automatically takes into account all case variants.

Conversely, you have to think about **listing the different variants of accentuation** (é, à, ç, û, ï...).\
Indeed, Visibrain considers a word with accent different than a word without accent.
{% endhint %}

{% hint style="warning" %}
**All operators work retroactively except those&#x20;**<mark style="color:orange;">**in orange**</mark>**.**

It is currently not possible to retrieve data retroactively on these operators.

At first, you can create a Topic without these operators to retrieve the data retroactively, then add them by editing the Topic afterwards.
{% endhint %}

## Tweet content operators

| Operator                                         | Explanation                                                                                                                                                                                                                                                                                                                           | Example                                                                                                                                                                                                                         |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **key-word**                                     | Captures all posts containing the keyword, or the keyword with a # in front (hashtag).                                                                                                                                                                                                                                                | <p><strong>car</strong><br>Captures all publications with the keyword "car" or the hashtag #car.</p>                                                                                                                            |
| **"exact expression"**                           | Captures all publications containing the exact expression, i.e. all the words of the phrase, in this precise order.                                                                                                                                                                                                                   | <p><strong>"blue car"</strong><br>Catch all posts with the keyword expression "blue car" in them.<br><br>Does NOT pick up the following content: <em>blue car and yellow car.</em></p>                                          |
| **#hashtag**                                     | Captures all posts containing the hashtag.                                                                                                                                                                                                                                                                                            | <p><strong>#car</strong><br>Captures all publications with the hashtag #car in it.<br><br>Does NOT pick up posts with the keyword "car", without #.</p>                                                                         |
| **emoji:**                                       | Captures all posts containing a specific emoji.                                                                                                                                                                                                                                                                                       | <p>😂<br>Captures all posts containing the "joy" emoji.</p>                                                                                                                                                                     |
| <mark style="color:orange;">**contains:**</mark> | Captures all posts containing the string "element", including inside a word. Operator not available for retroactive data recovery.                                                                                                                                                                                                    | <p><strong>contains:account</strong><br>Captures account, accountability, accountable, accounting ...</p><p>But also: nonaccountable, unaccounted ...<br></p>                                                                   |
| **lang: XX**                                     | <p>Allows you to take into account only publications in a particular language.<br><br><em>XX= language abbreviation.</em><br>The main languages: <strong>fr</strong> (French), <strong>en</strong> (English), <strong>es</strong> (Spanish), <strong>ja</strong> (Japanese).<br><br><em>See the list of available languages.</em></p> | <p><strong>motorcycle lang:fr</strong><br>Captures all French publications with the keyword "motorcycle" in it.<br><br><strong>motorcycle -lang:ja</strong><br>Does not pick up any publication in English, Japanese...<br></p> |

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

## Twitter account operators

| Operator              | Explanation                                                            | Example                                                                                                                                                                                                   |
| --------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **from:user**         | Captures all @user Twitter account activity.                           | <p><strong>from:Bloomberg</strong><br>Captures when @Bloomberg writes a tweet, or when @Bloomberg retweets another account. <strong>Do NOT pick up when another account retweets @Bloomberg.</strong></p> |
| **retweets\_of:user** | Captures retweets (made by other accounts) of tweets written by @user. | <p><strong>retweets\_of:Bloomberg</strong><br>Captures when @journalist1 retweets a tweet from @Bloomberg. <strong>Do NOT capture the initial tweet from @Bloomberg.</strong></p>                         |
| **@user**             | Captures when a tweet mentions @user                                   | <p><strong>@Bloomberg</strong><br>Captures when a user writes a tweet "read this on @Bloomberg". <strong>Do NOT pick up tweets from @Bloomberg.</strong></p>                                              |
| **to:user**           | Captures replies addressed to user @user                               | <p><strong>to:Bloomberg</strong><br>Capture replies to all tweets from @Bloomberg, and also all tweets starting with "@Bloomberg...". <strong>Does NOT pick up tweets from @Bloomberg.</strong></p>       |

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

{% hint style="danger" %}
The **from: retweets\_of: to:** and **url:** operators are used without the @ in the username.\
If you put the @, your rule will not work.
{% endhint %}

{% hint style="info" %}
**Don't forget the from:user operator**

The **retweets\_of:user**, **@user** or **to:user** operators used alone will not catch tweets written by @user, which can lead to strange behavior in the platform later.\
We recommend that you always use them in conjunction with the **from**: operator, for example:\
**from:user**\
**retweets\_of:user**
{% endhint %}

## Web content operators (articles, photos, videos)

<table><thead><tr><th width="271">Operator</th><th>Explanation</th><th>Example</th></tr></thead><tbody><tr><td><strong>url:key-word</strong><br><strong>url:"exact expression"</strong></td><td>Captures all web content whose URL contains the keyword (or exact expression).</td><td><strong>url:"bloomberg.com"</strong><br>Captures all publications from the bloomberg.com website</td></tr><tr><td><mark style="color:orange;"><strong>url_title:</strong></mark><strong>key-word</strong><br><mark style="color:orange;"><strong>url_title:</strong></mark><strong>"exact expression"</strong></td><td>Captures all web content whose title contains the keyword (or exact expression).<br><em>Operator not available for retroactive data recovery.</em></td><td><strong>url_title:"Breaking News"</strong><br>Captures all posts titled "Breaking News" (exact expression).<br><br><strong>url_title:Breaking</strong> <br><strong>url_title:News</strong><br>Captures all posts containing the keywords Breaking and News in their title (regardless of keyword order).</td></tr><tr><td><mark style="color:orange;"><strong>url_description:</strong></mark><strong>key-word</strong><br><mark style="color:orange;"><strong>url_description:</strong></mark><strong>"exact expression"</strong></td><td>Captures all web content whose body contains the keyword (or exact expression).<br><em>Operator not available for retroactive data recovery.</em></td><td><strong>url_description:Amazon</strong><br>Captures all articles with "Amazon" in their cap, and all YouTube videos with "Amazon" in their description.</td></tr></tbody></table>

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

## Operators on Twitter profiles

<table><thead><tr><th width="275">Operator</th><th>Explanation</th><th>Example</th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>bio:</strong></mark><strong>key-word</strong><br><mark style="color:orange;"><strong>bio:</strong></mark><strong>"exact expression"</strong></td><td>Captures all tweets from accounts whose biography contains the exact keyword or exact expression.<br><em>Operator not available for retroactive data recovery.</em></td><td><strong>bio:journalist</strong><br>Captures all tweets from accounts that have declared themselves as journalists in their bio.<br><br>(Does NOT pick up "journalists")</td></tr><tr><td><mark style="color:orange;"><strong>bio_name:</strong></mark><strong>key-word</strong><br><mark style="color:orange;"><strong>bio_name:</strong></mark><strong>"exact expression"</strong></td><td>Captures all tweets from accounts whose full name contains the exact keyword or exact expression.<br><em>Operator not available for retroactive data recovery.</em></td><td><strong>bio_name:"times"</strong><br>Captures all tweets with "Times" in their full name (eg: @nytimes, @TheTimes_UK...)</td></tr><tr><td><strong>profile_point_radius:[LON LAT RAD]</strong></td><td>Captures tweets from accounts that have been identified as being in a given circular area.<br><br>LON = longitude in degrees (±180)<br>LAT = latitude in degrees (±180)<br>RAD = radius of the circle, specifying the unit (between 0 and 25mi or between à and 40km)<br></td><td><strong>profile_point_radius:[2.3412 48.8569 50km]</strong><br>Captures all tweets from accounts that have been identified as in a city less than 50km from Paris.</td></tr><tr><td><strong>profile_bounding_box:[LON1 LAT1 LON2 LAT2]</strong></td><td>Captures tweets from accounts that have been identified as within a given rectangular area.<br><br>LON1 and LAT1 = longitude and latitude of the southwest corner of the rectangular area.<br><br>LON2 and LAT2 = longitude and latitude of the northeast corner of the rectangular area.<br><br>LON1, LAT1, LON2 and LAT2 in degrees (±180)<br></td><td><strong>profile_bounding_box:[-105.301758 39.964069 -105.178505 40.09455]</strong><br>Captures all tweets from accounts that have been identified as in a city within a rectangle around Boulder, Colorado, USA.</td></tr><tr><td><mark style="color:orange;"><strong>statuses_count:</strong></mark><strong>AAA</strong><br><mark style="color:orange;"><strong>statuses_count:</strong></mark><strong>AAA..BBB</strong></td><td>Captures all tweets from accounts with a certain activity under their belt.<br><br>AAA = lower bound<br>BBB = upper bound<br><br><em>Operator not available for retroactive data recovery</em></td><td><strong>statuses_count:100</strong><br>Captures all tweets from accounts that have made at least 100 tweets (in total).<br><br><strong>statuses_count:100..10000</strong><br>Captures all tweets from accounts that have tweeted at least 100 (total) but less than 10,000.<br></td></tr><tr><td><mark style="color:orange;"><strong>followers_count:</strong></mark><strong>AAA</strong><br><mark style="color:orange;"><strong>followers_count:</strong></mark><strong>AAA..BBB</strong></td><td>Captures all tweets from accounts with a certain number of followers.<br><br>AAA = lower bound<br>BBB = upper bound<br><br><em>Operator not available for retroactive data recovery</em></td><td><strong>followers_count:10000</strong><br>Captures all tweets from accounts with at least 10,000 followers.<br><br><strong>followers_count:10000..1000000</strong><br>Captures all tweets from accounts with at least 10,000 followers, but less than 1 million.</td></tr><tr><td><mark style="color:orange;"><strong>friends_count:</strong></mark><strong>AAA</strong><br><mark style="color:orange;"><strong>friends_count:</strong></mark><strong>AAA..BBB</strong></td><td>Captures all tweets from accounts with a certain number of followers.<br><br>AAA = lower bound<br>BBB = upper bound<br><br><em>Operator not available for retroactive data recovery</em></td><td><strong>friends_count:10</strong><br>Captures all tweets from accounts with at least 10,000 followers.<br><br><strong>friends_count:10..1000</strong><br>Captures all tweets from accounts with at least 10 followers, but less than 1000.</td></tr><tr><td><mark style="color:orange;"><strong>listed_count:</strong></mark><strong>AAA</strong><br><mark style="color:orange;"><strong>listed_count:</strong></mark><strong>AAA..BBB</strong></td><td>Captures all tweets from accounts that have been added to a number of lists.<br><br>AAA = lower bound<br>BBB = upper bound<br><br><em>Operator not available for retroactive data recovery</em></td><td><strong>listed_count:100</strong><br>Captures all tweets from accounts that have been added to at least 100 lists.<br><br><strong>friends_count:100..1000</strong><br>Captures all tweets from accounts added to at least 100 lists, but less than 1000.<br></td></tr><tr><td><strong>is:verified</strong></td><td>Captures all tweets from verified accounts.<br><br>LON = longitude in degrees (±180)<br>LAT = latitude in degrees (±180)<br>RAD = radius of the circle, specifying the unit (between 0 and 25mi or between à and 40km)</td><td><strong>coca is:verified</strong><br>Captures all tweets containing the keyword coca and written by verified accounts.</td></tr></tbody></table>

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

{% hint style="info" %}
**Identify influencers through operators on Twitter profiles.**

*Twitter profile operators are initially used to filter keywords. They can also be hijacked to be used without keywords and thus detect influencers, such as a Twitter profile search engine.*

Since most profile operators do not work retroactively, a Topic must be created and left active for a few days, and accounts must have tweeted at least once during the period to appear in the Visibrain platform.

For example, you can use the following rule:\
\&#xNAN;**(bio:journalist OR bio:writer) followers\_count:1000**\
to capture all the Twitter profiles of journalists, and having at least 1000 followers.
{% endhint %}

## Operators on Twitter GPS geolocation

The following operators on geolocation only concern tweets having activated GPS geolocation, ie: <0.5% of tweets.

| Operator               | Explanation                                                                                                                                                                                                                                         | Example                                                                                                        |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **place:"Place name"** | Captures tweets geolocated to a specific location.                                                                                                                                                                                                  | <p><strong>place:"Paris"</strong><br>Captures geolocated tweets in Paris.</p>                                  |
| **place\_country:XX**  | <p>Captures tweets that have been geolocated to a certain country.<br><br>XX = country abbreviation<br><br><em>The place\_country operator operates on the GPS geolocation of tweets having activated GPS geolocation, ie 0.5% of tweets.</em> </p> | <p><strong>place\_country:us</strong><br>Captures tweets geolocated in the United States</p>                   |
| **has:geo**            | Captures tweets that contain any geolocation information.                                                                                                                                                                                           | <p><strong>accident has:geo</strong><br>Captures all geotagged tweets that contain the keyword "accident".</p> |

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

## Advanced operators

The following advanced operators are useless for the majority of cases.\
We recommend that you give preference to the operators at the top of the page.\
\
If necessary, do not hesitate to contact your account manager so that he/she can advise you on the best rules to use in relation to your problem.

| Operator                                                                                       | Explanation                                                                                                                                                               | Example                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **"key-word1 key-word2"\~N**                                                                   | <p>Proximity operator between keywords.<br>N = number of words allowed between keyword 1 and keyword 2 (between 1 and 6).</p>                                             | <p><strong>"blue car"\~2</strong><br>Will capture "<em>my red and blue car</em>"<br>But won't pick up "<em>my red car and my blue van</em>"</p>                                                                                                                             |
| <mark style="color:orange;">**url\_contains:**</mark>**element**                               | <p>Captures all web content whose URL contains the word part "element".<br><br><em>Operator not available for retroactive data recovery</em></p>                          | <p><strong>url\_contains:times</strong><br>Captures all articles from thetimes.co.uk, nytimes.com...</p>                                                                                                                                                                    |
| **is:retweet**                                                                                 | Captures only retweets.                                                                                                                                                   | <p><strong>"weak signal" -is:retweet</strong><br>Picks up all original tweets containing the phrase "weak signal", but does not pick up related retweets.</p>                                                                                                               |
| **is:quote**                                                                                   | Only captures tweets that quote another tweet.                                                                                                                            | <p><strong>"to unroll" is:quote</strong><br>Captures all tweets containing the keyword "to unroll", and which point to another tweet.</p>                                                                                                                                   |
| **-is:nullcast**                                                                               | <p>Excludes ‘nullcasted’ posts (also known as ‘dark posts’), i.e. posts made from the advertising interface.</p><p>Can only be used for exclusion.</p>                    | **from:apple -is:nullcast**                                                                                                                                                                                                                                                 |
| **has:links**                                                                                  | Captures only tweets containing a link.                                                                                                                                   | <p><strong>"I like" -has:links</strong><br>Captures all tweets that contain the keyword phrase "I like", but do not contain a link.</p>                                                                                                                                     |
| <mark style="color:orange;">**sample:**</mark>**ZZ**                                           | <p>Allows you to retrieve only a sample of the data.<br><br>ZZ = a percentage, between 1 and 100<br><br><em>Operator not available for retroactive data recovery</em></p> | <p><strong>coca sample:10</strong><br>Captures 10% of content containing the keyword "coca".</p>                                                                                                                                                                            |
| **$SYMBOLE**                                                                                   | Captures all posts containing a specific cashtag.                                                                                                                         | <p><strong>$AMZN</strong><br>Captures all publications containing $AMZN, that is to say evoking the stock market quotation of the company Amazon.</p>                                                                                                                       |
| <mark style="color:orange;">**bio\_location:**</mark>**key-word**                              | <p>Captures all tweets from accounts with "keyword" in their "Location" field.<br><br><em>Operator not available for retroactive data recovery</em></p>                   | <p><strong>bio\_location:Eiffel</strong><br>Captures all tweets from people who put the keyword "Eiffel" in their "Location" field.</p>                                                                                                                                     |
| **has:profile\_geo**                                                                           | Captures all tweets from accounts for which Visibrain has managed to identify (from the "Location" profile field) the location.                                           | <p><strong>bonjour lang:fr has:profile\_geo</strong><br>Captures French-speaking tweets containing the keyword "Bonjour", and issued by accounts in which Visibrain has managed to identify the location.</p>                                                               |
| <mark style="color:orange;">**time\_zone:**</mark>**"timezone name"**                          | <p>Captures tweets from people who have entered a specific timezone in their profile.<br><br><em>Operator not available for retroactive data recovery</em></p>            | <p><strong>time\_zone:"Paris"</strong><br>Captures all tweets from profiles who have explicitly set their profile to the Paris timezone (GMT+1).</p>                                                                                                                        |
| <mark style="color:orange;">**source:**</mark>**"Twitter client name"**                        | <p>Captures tweets from a specific Twitter client (software).<br><br><em>Operator not available for retroactive data recovery</em></p>                                    | <p><strong>source:tweetdeck</strong><br>Captures tweets sent with TweetDeck (i.e. very often tweets from seasoned users)</p>                                                                                                                                                |
| **has:mentions**                                                                               | Captures tweets that mention another user.                                                                                                                                | <p><strong>bonjour -has:mentions</strong><br>Captures tweets that contain the keyword "hello", but don't mention another Twitter user.</p>                                                                                                                                  |
| **has:hashtags**                                                                               | Captures tweets containing at least one hashtag.                                                                                                                          | <p><strong>coca has:hashtags</strong><br>Captures tweets containing the keyword "coca", and any hashtag (for example: "#Love Coke")</p>                                                                                                                                     |
| **has:symbols**                                                                                | Captures tweets containing at least one cashtag.                                                                                                                          | <p><strong>breaking has:symbols</strong><br>Picks up tweets containing the keyword "breaking", and any cashtag (for example: "Breaking News, $AMZN stock up")</p>                                                                                                           |
| <p><strong>has:media</strong><br><strong>has:images</strong><br><strong>has:video</strong></p> | Captures tweets that contain attached media, or more specifically an image or video.                                                                                      | <p><strong>#NewYear has:media</strong><br>Captures tweets with the hashtag #newyear that contain an image or video.<br><br><strong>#NewYear has:video</strong><br>Captures tweets with the hashtag #newyear that contain a video (but not those that contain an image).</p> |
| <mark style="color:orange;">**retweets\_of\_status\_id**</mark>**:ID**                         | <p>Captures all retweets of a specific tweet.<br><br>ID = the exact id of the desired tweet<br><br><em>Operator not available for retroactive data recovery</em></p>      | <p><strong>retweets\_of\_status\_id:821391052594614272</strong><br>Captures all retweets of <a href="https://twitter.com/visibrain/status/821391052594614272">this tweet</a>.</p>                                                                                           |
| <mark style="color:orange;">**in\_reply\_to\_status\_id**</mark>**:ID**                        | <p>Captures all tweet replies to a specific tweet.<br><br>ID = the exact id of the desired tweet<br><br><em>Operator not available for retroactive data recovery</em></p> | <p><strong>in\_reply\_to\_status\_id:821391052594614272</strong><br>Captures all retweets of <a href="https://twitter.com/visibrain/status/821391052594614272">this tweet</a>.</p>                                                                                          |

*\*In <mark style="color:orange;">orange</mark>, non-retroactive operators.*

## Operators not available for retroactive recovery

Some operators (<mark style="color:orange;">in orange</mark>) are not available for past data recovery (but they work perfectly for real-time recovery).

You can create your Topic without them at first, then add them later.

If you have validated your Topic without retrieving past data, you can contact your account manager to have past data retrieved for you (on operators that allow it).

**Common operators not available in retroactive recovery:** contains:, url\_title, url\_description:, bio:, bio\_name:, status\_count:, followers\_count:, friends\_count:, listed\_count:

**Advanced operators not available in retroactive recovery:** url\_contains:, sample:, bio\_location:, time\_zone:, source:, retweets\_of\_status\_id:, in\_reply\_to\_status\_id