Use the following filters to focus only on the data you need.
Escaping reserved characters
If you need to use any of the characters which function as operators in your query itself (and not as operators), then you should escape them with a leading backslash. For instance, to search for external_links:https://www.linkedin.com*, you would need to write your query as external_links:https\:\/\/[www.linkedin.com\](http://www.linkedin.com\)\*
The reserved characters are: + - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /
Failing to escape these special characters correctly could lead to a syntax error which prevents your query from running.
Review Content Filters
| Parameter | Description | Example |
|---|---|---|
| language | The language of the review. The default is any. | Find reviews in French or Italian: (language:french OR language:italian) See Supported Languages under 'References' |
| author | Return reviews written by a specific author | Find reviews written by Admin: author:Admin |
| text | A textual Boolean query describing the keywords that should (or shouldn’t) appear in the review text. | text:(apple OR android) |
| external_links | Search for reviews that included links to another site. | Search for reviews that linked to LinkedIn (note that both the slashes and colons are prefixed by a backslash): https\:\/\/[www.linkedin.com\](http://www.linkedin.com\)\* |
| is_first | A Boolean parameter that specifies if to search only on the first review | is_first:true |
| rating | The rating parameter provides the star rating for the review. rating is a floating number between 0.0 to 5.0. | Return all the reviews with rating greater than 0: rating:>0 |
| published | A timestamp (in milliseconds) enabling you to filter reviews that were published before or after certain date/time. Here is a Timestamp/Date converter | Return reviews published after Thu, 30 Mar 2017 09:16:28 GMT: published:>1490865388000 |
Site Filters
| Parameter | Description | Example |
|---|---|---|
| site | Limit the results to a specific site or sites. | Limit the results to posts from Yahoo or CNN: (site:yahoo.com OR site:cnn.com) |
| item.country | Webz.io uses heuristics to determine the country origin of a site, by taking into account the site's IP, TLD and language. Many times the country origin isn't conclusive so it isn't set, therefor filtering by country may result in much less data than when filtering by language. | Return reviews from sites from France: item.country:FR To get a full country code list, visit our country codes index. |
| site_suffix | Limit the results to a specific site suffix | Return reviews from sites where their top level domain (TLD) ends with .fr: site_suffix:fr |
| site_full | Filter sites based on the domain and optionally by sub-domain | Return posts from App Store site_full:apps.apple.com |
| site_category | Limit the results to reviews originating from sites categorized as one (or more) of the following:
| Return posts from sites categorized as sports or games related: (site_category:sports OR site_category:games) |
| domain_rank | A rank that specifies how popular a domain is | Search for posts from the top 1,000 sites: domain_rank:<1000 |
Item Filters
An item contains global information about the content of the whole page and its content. An item can contain multiple reviews grouped together.
| Parameter | Description | Example |
|---|---|---|
| item.title | A textual Boolean query describing the keywords that should (or shouldn’t) appear in the item title. | Search for reviews containing the word "glass" and not "metal" in their title: thread.title:glass -thread.title:metal |
| item.section_title | A textual Boolean query describing the keywords that should (or shouldn’t) appear in the site’s section where the review was published | Search for the reviews under sections with a title that contains the word "electronics": item.section_title:electronics |
| item.url | Get all the reviews of a specific item (note that you must escape the http:// part of the URL like so: http://). | |
| item.published | A timestamp (in milliseconds) enabling you to filter posts that were published before or after certain date/time. Here is a Timestamp/Date converter | Return items published after Thu, 30 Mar 2017 09:16:28 GMT: thread.published:> 1490865388000 |
| crawled | A timestamp (in milliseconds) enabling you to filter items that were crawled before or after certain date/time. Here is a Timestamp/Date converter | Return items crawled after Thu, 30 Mar 2017 09:16:28 GMT: crawled:>1490865388000 |