# Searching Inside a Review

In the [Review Details](/application/review-details.md) and in [Article Search](/application/article-search.md) 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="/files/WGiW6tg6PQ69MQnTS1CT" 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](/application/review-details/author-country-of-origin.md) 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**](/configuration/monitor-configuration.md#filters)&#x20;

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

<figure><img src="/files/203lXF8b4kKxtf5d0YoU" 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="/files/TG5gQVUz2fPZIoyykg4s" 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="/pages/-MWAkDq9MJQmWV7X_PGG#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="/pages/wJMRZdZPacre8dDinH3l">/pages/wJMRZdZPacre8dDinH3l</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="/pages/wJMRZdZPacre8dDinH3l">/pages/wJMRZdZPacre8dDinH3l</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](/topics/mlm-ai-concepts.md#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](/configuration/monitor-configuration.md#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](/configuration/custom-workflows.md) 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](/configuration/monitor-configuration.md#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**](/application/reviews/find-articles-from-reviews.md) screen, where users can search into multiple reviews based on a date range, or monitors
{% endhint %}


---

# 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://docs.biologit.com/application/review-details/searching-abstracts-inside-a-review.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.