# Telegram

{% hint style="info" %}
You can use the `CTRL+F`  or `Command+F` to quickly find a specific filter in the table.
{% endhint %}

## Main filters&#x20;

| Filter                          | Use                                                                                                                                                                                                                                                                                           | Example                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **keyword**                     | Focus on all posts containing the keyword or the keyword prefixed with a #                                                                                                                                                                                                                    | <p><strong>car</strong><br>Will focus on posts containing the keyword or # car </p>                                                                                                                                                                                                                                                                                   |
| "**exact expression"**          | Focus on all the posts containing the exact expression : all the words of this expression, in this exact order.                                                                                                                                                                               | <p>"<strong>blue car"</strong> It focuses on all the posts with the key-expression 'blue car' in it. <br><br>It doesn't search for the following content : <em>the blue auto and the yellow car</em>.</p>                                                                                                                                                             |
| **#keyword**                    | Focus on all the posts containing a specific hashtag.                                                                                                                                                                                                                                         | **#car** It focuses on all the posts containing the hashtag #car. It won't search for the posts containing the keyword 'car' without a #.                                                                                                                                                                                                                             |
| **lang:**                       | <p>Focus on posts in a specific language. xx = language abbreviation <br><br>The main languages are : <br>- fr : french <br>- en : english <br>- es : spanish <br>- ja : japanese <a href="https://help.visibrain.com/useful-documents/list-of-languages">Check the 64 languages list</a></p> | <p><strong>lang:en</strong> <br>It focuses on all the english speaking posts.</p>                                                                                                                                                                                                                                                                                     |
| **contains:**&#x65;lement       | <p>Focus on all the posts containing a sequence of characters. <br><br><em>WARNING: this filter is not case & accent sensitive</em></p>                                                                                                                                                       | <p><strong>contains:</strong>blog <br><br>Will focus on posts containing the mentionned letters, will for example take into account keywords such as: <em>blog, bloger, blogs ...</em></p>                                                                                                                                                                            |
| **!contains:**&#x45;lement      | <p>Focus on a sequence of characters while being word case sensitive. </p><p></p><p><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                              | <p><strong>!contains:</strong>Gap </p><p></p><p>It focuses on all the posts containing the characters's list <strong>Gap</strong> while being sensitive to word case (only with a capital L). </p><p></p><p><em>This filter is very useful to focus on a proper noun for example the name of your brand).</em></p>                                                    |
| **full\_contains:**             | <p>Combines <em>contains / link\_title\_contains / link\_description\_contains / quoted\_contains</em></p><p></p><p></p><p>Focus on specific character sequence contained in posts, articles and reposts</p>                                                                                  | <p><strong>full\_contains:</strong>sport </p><p></p><p>Will focus on posts, articles, and quoted posts that contain the list of characters sport. Esport, parasport, watersports ... </p><p><br><em>This filter is very useful when you need to exclude data from all sources (posts / articles / quoted posts / replies)</em></p>                                    |
| **!full\_contains:**            | <p>Combines <em>!contains / !link\_title\_contains / !link\_description\_contains / !quoted\_contains</em> </p><p></p><p>Focus on specific character sequence contained in posts, articles and reposts</p><p></p><p><em>WARNING: this filter is case & accent sensitive</em></p>              | <p><strong>!full\_contains:</strong>Ford </p><p>It focuses on all the posts containing the following characters : Ford, but taking the case letter (only capital F) and accents into consideration.</p><p></p><p>Example : it will not take in "afford"</p><p></p><p><em>This filter is very useful if you want to focus on a name, proper noun, or a brand.</em></p> |
| **emoji:**                      | Focus on posts containing a specific emoji.                                                                                                                                                                                                                                                   | <p><strong>emoji:joy</strong> <br>It focuses on all the posts containing the emoji "<em>joy</em>"😂</p>                                                                                                                                                                                                                                                               |
| **has\_emoji:** (true/false)    | Focus on posts containing one or more emoji.                                                                                                                                                                                                                                                  | <p><strong>has\_emoji:true</strong> <br>It focuses on all the posts containing at least one emoji.</p>                                                                                                                                                                                                                                                                |
| **mention:**&#x75;ser           | <p>Filter on all the posts mentionning another account <br><br><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                                                   | <p><strong>mention:</strong>barackobama.bsky.social<br><br>It is only searching for posts in which Barack Obama's account is directly mentioned.</p>                                                                                                                                                                                                                  |
| **mention\_contains:**&#x75;ser | Filter on the posts mentioning accounts with a specific character sequence                                                                                                                                                                                                                    | <p><strong>mention\_contains:</strong>Tesco <br>It focuses on posts in which all accounts associated with Tesco (Tesco, Tesco news, Tesco mobile...) are mentioned.</p>                                                                                                                                                                                               |
| **proximity:**                  | Define a maximum distance between two or three keywords                                                                                                                                                                                                                                       | <p><strong>proximity:</strong>"apple samsung"<strong>\~4</strong><br>Focus on posts containing <em>Apple</em> and <em>Samsung</em> distanced by 4 keywords max </p>                                                                                                                                                                                                   |

## Account Filters

| Filter                                                   | Use                                                                                                                                                                                                                                                                                                                                     | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **from:**&#x75;ser                                       | <p>It allows you to focus on all the posts and reposts that have been generated by @user's posts. </p><p></p><p><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                                            | <p><strong>from:</strong>bloomberg.com<br><br>It allows you to focus on all the original posts published by Bloomberg and all the reposts that have been generated by his posts. <br><br>We can also use @bloomberg.com as a shortcut.</p>                                                                                                                                                                                                                               |
| **from\_contains:**                                      | <p>Focuses on posts made by accounts whose account-name contains a series of specific character sequence<br><br>Combines <em>chanel\_name\_contains: / display\_name\_contains:</em></p>                                                                                                                                                | <p><strong>from\_contains:</strong>news<br>Focuses on posts published by accounts that have the word <em>news</em> in their username or displayname</p>                                                                                                                                                                                                                                                                                                                  |
| **channel\_name\_contains:**                             | Focuses on posts made by accounts whose channel name contains a series of specific character sequence                                                                                                                                                                                                                                   | <p><strong>username\_contains:</strong>gov<br>Focuses on posts published by accounts that have the word <em>news</em> in their channel name</p>                                                                                                                                                                                                                                                                                                                          |
| <p><strong>!channel\_name\_contains:</strong></p><p></p> | <p>Focuses on posts made by accounts whose channel name contains a series of specific character sequence<br><br><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                                            | <p><strong>!username\_contains:</strong>Ford </p><p>It focuses on all the posts published by accounts that have the word <em>Ford</em> in their channel name</p><p></p><p>Example : it will not take "afford"</p><p></p><p><em>This filter is very useful if you want to focus on a name, proper noun, or a brand.</em></p>                                                                                                                                              |
| **display\_name\_contains:**                             | It allows you to isolate the activity of the users whose the display name is a specific character sequence                                                                                                                                                                                                                              | **display\_name:**&#x44;ior It focuses on the activity of the users whose display name is "Dior".                                                                                                                                                                                                                                                                                                                                                                        |
| **!display\_name\_contains:**                            | <p>It allows you to isolate the activity of users whose display name contains a specific character sequence<br><br><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                                         | <p>!<strong>display\_name\_contains:</strong>Media <br><br>It filters on the activity of users whose display name contains the sequence of characters Media<br><br>It allows you to find all the official accounts of big Media</p>                                                                                                                                                                                                                                      |
| **profile\_contains:**                                   | <p>Combines <em>bio\_contains / channel\_name\_contains/display\_name\_contains/</em><br></p><p>Filter on the activity of users that have a specific character sequence in users' biography; display name or username, in order to identify communities</p>                                                                             | <p><strong>profile\_contains:</strong>government <br>Will focus on the activity of accounts that the character sequence governement in their bio, username or displayname. <br><br><em>This will be very useful when looking to focus on the activity of a large group of users.</em></p>                                                                                                                                                                                |
| **!profile\_contains:**                                  | <p>Combines <em>!bio\_contains / !channel\_name\_contains / !display\_name\_contains /</em> </p><p></p><p>Filter on the activity of users that have a specific character sequence in users' biography; display name or username, in order to identify communities. <br><br><em>WARNING: this filter is case & accent sensitive</em></p> | <p><strong>!profile\_contains:</strong>Washington <br><br>Will focus on the activity of users that have the sequence of characters Washington in their bios, screen or display names and taking into consideration the capital W. <br><br>For example accounts for the Washington Post</p><p><br></p>                                                                                                                                                                    |
| **bio:**                                                 | It allows you to focus on a keyword contained in biographies, in order to identify communities.                                                                                                                                                                                                                                         | <p><strong>bio:journalist</strong> It focuses on the user's activity whose biography contains the word "journalist". It won't search for the word "journalists" or "journalistic". <br><br>It can be helpful if you want to identify users declaring a specific interest : </p><p></p><p><strong>bio:football</strong> <br>It will list all the users that have participated to the analyzed topic and that have mentioned the keyword "football" in their biography</p> |
| **bio\_contains:**                                       | It allows you to filter on a specific character sequence in channels' biographies, in order to identify communities                                                                                                                                                                                                                     | <p><strong>bio\_contains:</strong>blog <br>It filters on channels, whose biography contains "blog", activity<br>It allows to increase the research : blog, blogging, blogger... <br><br>It can be helpful to identify users declaring a specific interest for something : <strong>bio\_contains:</strong>fashion <br><br>It will list all the users that have participated to the analyzed topic and that have mentioned fashion in their biography </p>                 |
| **!bio\_contains:**                                      | <p>It allows you to filter on a specific character sequence  in channels' biographies, in order to identify communities. <br><br><em>WARNING: this filter is case & accent sensitive</em></p>                                                                                                                                           | <p><strong>!bio\_contains:</strong>Total <br>It will list all the users that have participated to the analyzed topic and that have mentioned the brand Total in their biography (Total employees, trade unionist...</p>                                                                                                                                                                                                                                                  |
| **followers\_count:** (\</>/=)                           | It allows you to sort users according to a certain amount of followers.                                                                                                                                                                                                                                                                 | <p><strong>followers\_count:>5000</strong> <br>It focuses on the activity of users having more than 5000 followers.</p>                                                                                                                                                                                                                                                                                                                                                  |

## Content filters

| Filter                                                                 | Use                                                                         | Example                                                                                                                                                                         |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>hashtag\_count</strong>: <br>(\</>/=)</p>                   | Sort posts according to the number of hashtag they contain.                 | <p><strong>hashtag\_count:<10</strong> <br>Focus on all the posts that contain less than 10 hashtags.</p>                                                                       |
| <p><strong>mention\_count:</strong> <br>(\</>/=)</p>                   | Sort posts according to the number of accounts mentioned.                   | <p><strong>mention\_count:<5</strong><br>Focus on posts mentioning less than 5 accounts</p>                                                                                     |
| <p><strong>word\_count</strong>: <br>(\</>/=)</p>                      | Sort posts according to the number of words (without hashtags) contained    | <p><strong>word\_count:>10</strong><br>Focus on posts containing more than 10 words.</p>                                                                                        |
| <p><strong>sentiment:</strong> <br>(neutral / positive / negative)</p> | Sort posts according the identified sentiment                               | <p><strong>sentiment:</strong>negative<br>Focus on posts that have been identified as negative</p>                                                                              |
| <p><strong>views:</strong> <br>(\</>/=)</p>                            | Focus on the posts with a defined number of generated views                 | <p><strong>views:>30000</strong> <br>Filter on posts that have generated more than 30000 views.</p>                                                                             |
| <p><strong>content\_type:</strong> <br>(photo/video)</p>               | Filter the posts according to the type of media shared : photos or videos.  | <p><strong>content\_type:video</strong> <br>Focus on all posts that are videos.</p>                                                                                             |
| **country:**                                                           | Focus on channels according to their declared country                       | <p><strong>country:fr</strong> <br>Focus on the activity of channels that are located in France.</p>                                                                            |
| **city:**                                                              | Focus on channels according to their declared city                          | <p><strong>city:</strong>paris <br>Focus on the activity of channels that are located in Paris.</p>                                                                             |
| <p><strong>is\_reply:</strong> <br>(true/false)</p>                    | It allows you to focus on all the posts that are replying to other posts.   | <p><strong>mention:mybrand</strong> <strong>is\_reply:true</strong> <br>It focuses on all the posts that mention @mybrand, but that are also answering to @mybrand's posts.</p> |
| <p><strong>is\_repost:</strong> <br>(true/false)</p>                   | It allows you to focus on all the posts that are reposting posts as content | <p><strong>is\_repost:</strong>true<br>Focus on posts reposting  posts as content</p>                                                                                           |
| **post:**                                                              | Allows you to identify a specific publication                               | <p>post:‘d00a9e48-31da-5a1d-acd5-7406c691e4c4’</p><p>Focuses on a specific Telegram post thanks to the ID contained in its URL</p>                                              |

## Link Filters

| Filter                      | Use                                                                                                                                           | Example                                                                                                                                                                                    |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **domain\_contains:**       | Isolate all the articles coming from a website whose name contains a specific character sequence                                              | <p><strong>domain\_contains:</strong>blog <br>Focus on links coming from a website whose domain contains "blog"</p>                                                                        |
| **url\_contains:**          | It allows you to isolate the articles whose URL contains a specific character sequence                                                        | <p><strong>url\_contains:</strong>scandal <br>Focus on the articles whose URL contains <em>scandal</em><br>It will take into consideration : <em>scandal, scandalize, scandals...</em></p> |
| **link\_title\_contains:**  | Isolate articles whose title contain a specific character sequence                                                                            | <p><strong>link\_title\_contains:</strong>tax <br>Focus on articles whose title contains : <em>tax</em><br>It will take into consideration : <em>tax, taxi, taxing, taxpayer...</em></p>   |
| **!link\_title\_contains:** | <p>Isolate articles whose title contains a specific character sequence</p><p><br><em>WARNING: this filter is case & accent sensitive</em></p> | <p><strong>!link\_title\_contains:</strong>PSG <br>Focus on articles whose title contain <em>PSG</em> in caps</p>                                                                          |
