# News

## Filters common accross all platforms

<table><thead><tr><th width="236.21875">Filter</th><th width="233.5859375">Usage</th><th>Example</th></tr></thead><tbody><tr><td><strong>keyword</strong></td><td>Focuses on all articles containing the keyword</td><td><p><strong>car</strong> </p><p></p><p>Focuses on all articles containing the keyword "car"</p></td></tr><tr><td><strong>"exact expression"</strong></td><td>Focuses on all articles containing the exact phrase, i.e., all words in the phrase in this precise order</td><td><p><strong>"blue car"</strong> </p><p></p><p>Focuses on all articles containing the exact phrase "blue car"". Does NOT search for content like "blue automobile" or "yellow car"</p></td></tr><tr><td><strong>lang:</strong></td><td><p>Considers only articles in a specific language. xx = language abbreviation. Main languages: fr = French, en = English, es = Spanish, ja = Japanese. </p><p><a href="/users/57c74e0db97f6310002c0956">See list of 64 available languages</a></p></td><td><p><strong>lang:</strong>en</p><p></p><p>Focuses on all English-language articles</p></td></tr><tr><td><strong>contains: / full_contains:</strong></td><td>Focuses on articles containing a sequence of characters. Filter is not case or accent sensitive</td><td><p><strong>contains:</strong>treat</p><p></p><p>Focuses on all content like treats, treatment, treated, but also mistreat, mistreating, etc.</p></td></tr><tr><td><strong>!contains: / !full_contains:</strong></td><td>Focuses on a sequence of characters while being case-sensitive</td><td><p><strong>!contains:</strong>Innov</p><p></p><p>Focuses on all publications containing "Innov" but sensitive to case and accent (I uppercase, é accented). Useful for proper names, e.g., your brand name</p></td></tr><tr><td><strong>emoji:</strong></td><td>Focuses on publications containing a specific emoji</td><td><p><strong>emoji:</strong>joy </p><p></p><p>Focuses on all publications containing the emoji 😂</p></td></tr><tr><td><strong>has_emoji: (true/false)</strong></td><td>Focuses on publications containing one or more emojisFocuses on publications containing one or more emojis</td><td><p><strong>has_emoji:</strong>true </p><p></p><p>Focuses on all publications containing at least one emoji</p></td></tr><tr><td><strong>sentiment:</strong> (neutral / positive / negative)</td><td>Sorts articles based on identified sentiment</td><td><p><strong>sentiment:</strong>negative </p><p></p><p>Isolates all articles identified as negative</p></td></tr><tr><td><strong>proximity:</strong></td><td>Defines a maximum distance between multiple keywords</td><td><p><strong>proximity:</strong>"apple samsung"~4</p><p></p><p>Focuses on articles containing "Apple" and "Samsung" within 4 words</p></td></tr><tr><td><strong>!proximity:</strong></td><td>Defines a maximum distance between multiple keywords while respecting case</td><td><p>!proximity:"Airbus failure"~4</p><p></p><p>Focuses on publications containing "failure" and "Airbus" within 4 words, keeping "Airbus" capitalized</p></td></tr><tr><td><strong>char_count:</strong><br>(&#x3C;/>/=)</td><td>Filter posts by the number of characters in a post.</td><td><strong>char_count:</strong>&#x3C;50<br>Filters posts with fewer than 50 characters.</td></tr></tbody></table>

## Filters on the transmitters

<table><thead><tr><th width="236.21875">Filter</th><th width="233.5859375">Usage</th><th>Example</th></tr></thead><tbody><tr><td><strong>from: / website_url:</strong></td><td>Allows filtering articles published by a specific media outlet</td><td><p><strong>from:</strong>"https://www.huffpost.com/"</p><p></p><p>Identifies all articles published by the Huffington's post</p></td></tr><tr><td><strong>from_contains: / website_url_contains:</strong></td><td>Isolates articles published by media groups whose account name contains specific character sequences</td><td><p><strong>from_contains:</strong>MSN </p><p></p><p>Identifies articles published by MSN, MSN France, MSN Belgium, MSN Québec, etc.</p></td></tr><tr><td><strong>site_name_contains:</strong></td><td>Isolates articles published by media whose account name contains specific character sequences</td><td><p><strong>site_name_contains:</strong>yahoo</p><p></p><p>Identifies articles published by media whose name includes Yahoo</p></td></tr><tr><td><strong>!site_name_contains:</strong></td><td>Isolates articles published by media whose account name contains specific characters, while being case-sensitive</td><td><p><strong>!site_name_contains:</strong>Sky</p><p></p><p>Identifies articles from media whose name contains "Sky" with an uppercase “S”</p></td></tr><tr><td><strong>author:</strong></td><td>Filters articles written by a specific author</td><td><p><strong>author:</strong>"Josselin Tallec"</p><p></p><p>Identifies articles written by Josselin Tallec</p></td></tr><tr><td><strong>author_contains:</strong></td><td>Filters articles written by authors whose name contains specific character sequences</td><td><p><strong>author_contains:</strong>smith</p><p></p><p>Identifies articles written by journalists whose name contains "smith"</p></td></tr><tr><td><strong>!author_contains:</strong></td><td>Filters articles written by authors whose name contains specific characters, case-sensitive</td><td><p><strong>!author_contains:</strong>Franck </p><p></p><p>Identifies articles written by journalists whose name contains "Franck" with an uppercase “F”</p></td></tr><tr><td><strong>domain:</strong></td><td>Isolates all articles coming from a specific website</td><td><p><strong>domain:</strong>mediapart</p><p></p><p>Filters articles from Mediapart</p></td></tr><tr><td><strong>domain_contains:</strong></td><td>Isolates articles from websites whose domain name contains specific characters</td><td><p><strong>domain_contains:</strong>blog </p><p></p><p>Filters links from websites whose domain includes "blog"</p></td></tr><tr><td><p><strong>type:</strong></p><p><strong>(news/blog)</strong></p></td><td>Isolates press or blog articles</td><td><p>type:blog</p><p></p><p>Isolates articles from blog-type media</p></td></tr><tr><td><strong>country:</strong></td><td>Filters articles published by media from a specific country</td><td><p><strong>country:</strong>fr </p><p>Filters articles from French media</p></td></tr><tr><td><p><strong>views:</strong></p><p><strong>(> / &#x3C; / =)</strong></p></td><td>Sorts articles based on a threshold of generated views</td><td><p><strong>views:</strong>&#x3C;500000</p><p></p><p>Filters articles that generated more than 500,000 views</p></td></tr><tr><td><p><strong>audience:</strong></p><p><strong>(> / &#x3C; / =)</strong></p></td><td>Sorts articles by the audience level of the publishing media</td><td><p><strong>audience:</strong>&#x3C;30000</p><p></p><p>Filters media with an audience greater than 30,000</p></td></tr><tr><td><p><strong>has_authors:</strong></p><p><strong>(true/false)</strong></p></td><td>Isolates articles without listed authors</td><td><p><strong>has_authors:</strong>false</p><p></p><p>Filters articles with no author specified</p></td></tr><tr><td><p><strong>monthly_visits_count:</strong></p><p><strong>(> / &#x3C; / =)</strong></p></td><td>Sorts websites based on their monthly visit count</td><td><p><strong>monthly_visits_count:</strong>>100000 </p><p></p><p>Filters media generating at least 100,000 monthly visits</p></td></tr></tbody></table>

## Filters on content

<table><thead><tr><th width="236.21875">Filter</th><th width="233.5859375">Usage</th><th>Example</th></tr></thead><tbody><tr><td><strong>word_count: (&#x3C;/>/=)</strong></td><td>Filters publications based on the number of keywords</td><td><p><strong>word_count</strong>:&#x3C;5 </p><p></p><p>Filters publications with fewer than 5 keywords</p></td></tr><tr><td><strong>title_contains:</strong></td><td>Isolates articles whose title includes specific characters</td><td><p><strong>link_title_contains</strong>:car </p><p></p><p>Filters articles whose title contains "car" (car, cars, carnivore, carnival etc...)</p></td></tr><tr><td><strong>!title_contains:</strong></td><td>Isolates articles whose title includes specific characters, case-sensitive</td><td><p><strong>!link_title_contains:</strong>Macy's</p><p></p><p>Filters articles mentioning "Macy's" (brand), excluding the name</p></td></tr><tr><td><strong>summary_contains:</strong></td><td>Isolates articles whose summary includes specific characters</td><td><p><strong>summary_contains:protest</strong></p><p></p><p>Filters articles whose summary includes "protest" (protests, protesting, etc.)</p></td></tr><tr><td><strong>!summary_contains:</strong></td><td>Isolates articles whose summary includes specific characters, case-sensitive</td><td><p><strong>!summary_contains:</strong>Tesco</p><p></p><p>Filters articles mentioning "Tesco"</p></td></tr><tr><td><strong>url_contains:</strong></td><td>Isolates articles whose web address (URL) includes specific characters</td><td><p><strong>url_contains:</strong>scandal</p><p></p><p>Filters links whose URL includes "scandal", "scandals", "scandalous", etc.</p></td></tr><tr><td><strong>paywall: (true/false)</strong></td><td>Isolates articles that are behind a paywall</td><td><p><strong>paywall:</strong>false</p><p></p><p>Filters articles that are free to read</p></td></tr></tbody></table>


---

# 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/news.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.
