# 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> </p><p>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.                                                                                                                                                                                                                                         | <p><strong>#car</strong> </p><p>It focuses on all the posts containing the hashtag #car. It won't search for the posts containing the keyword 'car' without a #.</p>                                                                                                                                                                                                  |
| **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>                                                                                                                                                                                                   |
| <p><strong>char\_count:</strong><br>(\</>/=)</p> | Filter posts by the number of characters in a post.                                                                                                                                                                                                                                           | <p><strong>char\_count:</strong><50<br>Filters posts with fewer than 50 characters.</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>                                                                          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.visibrain.com/filters-and-helpful-documents/list-of-operators-to-add-filters/telegram.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
