# Filters

Filters are `field:value` clauses inside the `q` parameter. Combine them freely with free-text terms and boolean operators - see [Query Syntax](reviews-api-query-syntax).

## Review fields

| Filter | Example | Meaning |
| --- | --- | --- |
| `rating:` | `rating:>=4` | Review rating, supports ranges |
| `author:` | `author:"jane doe"` | Review author |
| `language:` | `language:english` | Review language (full name, case-insensitive) |
| `title:` | `title:disappointed` | Term in the review title |
| `text:` | `text:"stopped working"` | Term in the review body |
| `published:` | `published:>1751536320000` | Publish time (Unix milliseconds) |
| `crawled:` | `crawled:>1751536320000` | Crawl time (Unix milliseconds) |
| `ord_in_thread:` | `ord_in_thread:0` | Position among the item's reviews |

## Item fields

The reviewed item (product page, hotel, business) is filtered with `item.` fields. The `item.` prefix is optional for the fields below - `site:amazon.com` works the same as `item.site:amazon.com`.

| Filter | Example | Meaning |
| --- | --- | --- |
| `item.site:` | `item.site:amazon.com` | Reviews from a domain |
| `item.site_full:` | `item.site_full:www.amazon.co.uk` | Exact host |
| `item.site_suffix:` | `item.site_suffix:co.uk` | Domain suffix |
| `item.site_section:` | `item.site_section:electronics` | Section of the site |
| `item.section_title:` | `item.section_title:laptops` | Title of the section |
| `item.title:` | `item.title:"acme blender"` | Term in the item title |
| `item.url:` | `item.url:"https://www.amazon.com/dp/..."` | Item URL |
| `item.published:` | `item.published:>1751536320000` | When the item page was published |
| `item.country:` | `item.country:US` | Source country (2-letter code) |
| `item.domain_rank:` | `item.domain_rank:<1000` | Domain rank range |
| `item.reviews_count:` | `item.reviews_count:>50` | Total reviews on the item |
| `item.reviewers_count:` | `item.reviewers_count:>20` | Distinct reviewers on the item |

## Filter with URL parameters

Any filter can also be sent as its own query parameter for exact matching (`&language=english`), or negated with an `exclude_` prefix (`&exclude_site=amazon.com`). Values sent this way must match exactly - ranges and wildcards belong in `q`.
