Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Filters Reference

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

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)

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):

external_links:https\:\/\/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, a floating number between 0.0 to 5.0.

Return all the posts with rating greater than 0:

rating:>0

published

A time-stamp (in milliseconds) enable you to filter reviews that were published before or after certain date/time.

Return posts published after Thu, 30 Mar 2017 09:16:28 GMT:
published:>1490865388

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

Webhose.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:
thread.country:FR

To get the full country code list, visit countrycode.org.

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 their sub-domain

Return posts from Trustpilot Denmark:

site_full:dk.trustpilot.com

site_category

Limit the results to posts originating from sites categorized as one (or more) of the following:

  • search_engine
  • entertainment
  • shopping
  • vehicles
  • gambling
  • tech
  • games
  • sports
  • finance
  • hacking
  • social
  • messaging
  • health
  • personals
  • religion
  • travel
  • abortion
  • education
  • drugs
  • business
  • advertising
  • humor
  • food
  • real_estate
  • virtual_reality
  • jobs
  • media
  • adult
  • alcohol_and_tobacco
  • weapons

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 (by monthly traffic)

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\:\/\/).

spam_score

A score value between 0 to 1, indicating how spammy the thread text is.

Return items with spam score lower or equals to 0.8:

spam_score:<=0.8

item.published

A time-stamp (in milliseconds) enable you to filter items that were published before or after certain date/time.

Return items published after Thu, 30 Mar 2017 09:16:28 GMT:
thread.published:>1490865388

crawled

A time-stamp (in milliseconds) enable you to filter items that were crawled before or after certain date/time.

Return items crawled after Thu, 30 Mar 2017 09:16:28 GMT:
crawled:>1490865388

Filters Reference