# Searching Inside a Review

In the [Review Details](https://docs.biologit.com/application/review-details) and in [Article Search](https://docs.biologit.com/application/article-search) the search box can be used to filter results using keywords, by tags and many other attributes.

## Keyword Matching

The simplest method is just to type the key terms to be matched. These will be searched in the title, abstract and publication name:

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2Fv4CVqTSjihXuWG9UPkeN%2Fimage.png?alt=media&#x26;token=788671bf-acbb-4f9e-b086-10b2b2d3dd00" alt=""><figcaption></figcaption></figure>

Users can also search according to AI tags, screening decisions, comments and source data. Lets look at how this is possible with the results query language:

## Query by Attribute

Results can be filtered by AI tag, contents of decision, author country of origin and many other attributes. They can also be combined in a single query.

Lets look at some examples:

### Example Queries

| Task                                                                                                                                                             | Query                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Retrieve all articles tagged as "Suspected AE"                                                                                                                   | `tag:ae` (or `tag:adverse)`        |
| Retrieve all articles containing the word "acetamoniphen" AND containing a patient mention (patient tag)                                                         | `match:acetaminophen tag:patient`  |
| Retrieve articles NOT flagged as a special situation AND flagged as aggregate report                                                                             | `notag:special decision:aggregate` |
| Only articles from PubMed                                                                                                                                        | `source:pubmed`                    |
| Articles where the [main author affiliation](https://docs.biologit.com/application/review-details/author-country-of-origin) is from Portugal OR Ireland OR Japan | `mainauthor:PT,IE,JP`              |

### Querying with Multiple Criteria

When adding different attributes in the same query, they are considered as an AND query

Example:

* Match results with Suspect Adverse tag **AND** the keyword "acetaminophen" in contents
* `tag:adverse match:acetamoniphen`

If different criteria are combined by a comma (`,`) they are treated like an **OR** search:

Example:

* Results where main author is from US or Ireland or Portugal:
* `mainauthor:US,IE,PT`

Finally, both methods can be combined for more sophisticated searches:

* `tag:adverse mainauthor:US,IE,PT`
* (results tagged as Suspect Adverse AND where the main author is from US or Ireland or Portugal)

### Pre-defined Filters

Monitors can be configured with pre-defined filters that can later be used as shortcuts from the search box. This facilitates reusing complex queries.

👉 Check out the steps on [**how to configure pre-defined Monitor filters**](https://docs.biologit.com/configuration/monitor-configuration#filters)&#x20;

In the example below there are two filters configured for the sample Monitor:

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FeOgh4kVYkD8Jlw1RLDO7%2Fimage.png?alt=media&#x26;token=4ada6541-a0bc-4bf3-9e14-f18ba0f02512" alt=""><figcaption></figcaption></figure>

In the Review search box, the filters appear as shortcuts in place of the actual query. Once selected the configured query runs:

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2F8zTBmAqkmsuQXVHrKNb4%2Fimage.png?alt=media&#x26;token=0f52ef3f-f6c4-4179-ac2c-9d8e1a2c2037" alt=""><figcaption></figcaption></figure>

### Reference: All Query Options

<table><thead><tr><th width="169.90183822506123">Parameter</th><th>What it does</th></tr></thead><tbody><tr><td><a href="#match-less-than-value-greater-than"><code>match</code></a><code>:</code></td><td><ul><li>Match specified keyterms in article title and publication name</li><li>Use <code>nomatch:</code> for the opposite query.</li></ul></td></tr><tr><td><a href="#tag-less-than-value-greater-than"><code>tag</code></a><code>:</code></td><td><ul><li>Match only articles with a specific <a href="../../../topics/mlm-ai-concepts#ai-tags">AI Tag</a>. (for the opposite effect use <a href="#notag-less-than-value-greater-than"><code>notag</code></a><code>:</code></li></ul></td></tr><tr><td><a href="#by-less-than-user-greater-than"><code>by</code></a><code>:</code></td><td><ul><li>Matches articles last updated by user matching <code>&#x3C;user></code> (use <code>nouser:</code> for the opposite query)</li></ul></td></tr><tr><td><a href="#source-less-than-source-greater-than"><code>source</code></a><code>:</code></td><td><ul><li>Matches articles from a given source (pubmed, doaj, crossref, etc.)</li><li>For the opposite query use <code>nosource:</code></li></ul></td></tr><tr><td><a href="#comment-less-than-comment-greater-than"><code>comment</code></a><code>:</code></td><td><ul><li>Matches the contents in article's comment section of the most recent screening decision (if any)</li><li>For the opposite query use <code>nocomment:</code></li></ul></td></tr><tr><td><a href="#decision-less-than-decision-greater-than"><code>decision</code></a><code>:</code></td><td><ul><li>Select specific review or QC decisions. Ex: <code>decision:serious</code></li><li>For the opposite result use <code>nodecision:</code></li></ul></td></tr><tr><td><code>mainauthor:</code></td><td><ul><li>Select according to main author's country of origin.</li><li>See: <a data-mention href="author-country-of-origin">author-country-of-origin</a></li></ul></td></tr><tr><td><code>anyauthor:</code></td><td><ul><li>Select according to any of the author's country of origin.</li><li>See: <a data-mention href="author-country-of-origin">author-country-of-origin</a></li></ul></td></tr><tr><td><a href="https://app.gitbook.com/o/jj4cAbkJRlFV7NUEATGJ/s/6pIe8UPxEvsbrxTVXkGi/~/changes/111/application/review-details/searching-abstracts-inside-a-review#issn-less-than-issn-greater-than"><code>issn</code></a><code>:</code></td><td><ul><li>Matches based on source ISSN of an article</li></ul></td></tr><tr><td><a href="https://app.gitbook.com/o/jj4cAbkJRlFV7NUEATGJ/s/6pIe8UPxEvsbrxTVXkGi/~/changes/111/application/review-details/searching-abstracts-inside-a-review#dueby-less-than-days-greater-than"><code>dueby</code></a><code>:</code></td><td><ul><li>Select based on the number of days left before review submission deadline</li></ul></td></tr></tbody></table>

### Query Options

#### match: \<value>

Match specified keyterms in article title and publication name. This is also the default behavior when not using the `param: <value` syntax.

* **Usage**: `match:key terms`

Examples:

* `match:case`

#### tag: \<value>

Match only articles with a specific [AI Tag](https://docs.biologit.com/topics/mlm-ai-concepts#ai-tags). Tags can be specified as follows

* Usage: `tag:value`

Examples:

* `tag:ae`  (articles tagged "Suspected AE", can also use `tag: adverse`)
* `tag:patient` (articles with a confirmed patient mention)
* `tag:special` (articles tagged with any special situation)
* `tag:case` (suspected case tag)
* `tag:keyword` (articles matching [user defined keywords](https://docs.biologit.com/configuration/monitor-configuration#user-defined-keywords) configured in the monitor)

#### **notag: \<value>**

Performs the inverse of tag: matches articles that *do not* contain stated tag.

* `notag:ae` (articles not tagged "Suspected AE" )

#### by: \<user>

Matches articles last updated by user matching `<user>`

Example:

* `by:mlmai`

#### source: \<source>

Matches articles from a given source (pubmed, doaj, crossref, etc.)

Example:

* `source:doaj`

#### **comment:\<comment>**

Matches the contents in article's comment section of the most recent screening decision (if any)

Example:

* `comment:duplicate`

#### decision:\<decision>

Matches articles with a specific review decision:

Examples:

* Serious events: `decision:serious`
* Aggregate reporting: `decision:agg`
* Safety signal: `decision:signal`

Decision labels from [custom workflows](https://docs.biologit.com/configuration/custom-workflows) are also accepted:

* `decision:Pending Translation`

Note: use `nodecision:` to retrieve opposite results.

#### issn:\<issn>

Returns all articles that match a provided ISSN, or do not have an associated ISSN.

#### dueby:\<days>

Matches articles based on the number of days left before the deadline of review submission. For example, `dueby:5`  will fetch all articles a review for which:

* should be submitted within 5 days or less
* is already overdue (deadline for review submission has already passed)

See [Sources and Search Schedule](https://docs.biologit.com/configuration/monitor-configuration#sources-and-search-schedule) part of the monitor configuration guide for more details on how the deadline date is calculated.

{% hint style="info" %}
The search box is also available from the [**Find Articles**](https://docs.biologit.com/application/reviews/find-articles-from-reviews) screen, where users can search into multiple reviews based on a date range, or monitors
{% endhint %}