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 (1+1)=2, you would need to write your query as (1+1)\=2.

The reserved characters are: + - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /

Failing to escape these special characters correctly could lead to a syntax error which prevents your query from running.

Content Filters

Parameter
Description
Example

name

The name of the product

Find products that contain "smartwatch" or "smart watch" in their names:

(name:smartwatch OR name:"smart watch")

language

The language of the product name & description. The default is any.

Find products in French or Italian:

(language:french OR language:italian)

description

The description of the product

Find products mentioning the words wireless and charger:

(description:wireless AND description:charger)

section_title

A textual Boolean query describing the keywords that should (or shouldn’t) appear in the site’s section where the product was published

Search for the products containing the word watch only under sections with a title that contains the word "wear":

(section_title:wear) AND watch

last_changed

The date the product was updated (change in price, or stock status)

Return products that their price changed after a certain date (timestamp):
last_changed:>1488814088387

Product Properties Filters

Parameter
Description
Example

brand

The brand manufacturing the product

Filter products made by GoPro:

brand:gopro

price

The price of the product

Filter products that cost less than 300$:

price:<300

offer_price

Special offers on a product

Filter products that got a special offer less than 300$:

offer_price:<300

in_stock

Boolean filter stating if the product is in stock or not

Filter products that are in stock:
in_stock:true

on_sale

Boolean filter for products that state that they are on sale.

Filter products that state that they are on sale:
on_sale:true

category

Under which category is the product under. You can enter a free text category, but there are also predefined categories:

  • acne-blemish-treatments
  • anti-aging-products
  • baby
  • books
  • business-industrial
  • camera
  • cars
  • cases-covers-skins
  • cell-phones-accessories
  • cell-phones-smartphones
  • clothing-shoes-accessories
  • computers-tablets-networking
  • computers
  • crafts
  • desktops-all-in-ones
  • dresses
  • electronics
  • fashion
  • fragrances
  • health-beauty
  • home-garden
  • jewelry
  • laptops-netbooks
  • lenses
  • moisturizers
  • music
  • pc-desktops-all-in-ones
  • pc-laptops-netbooks
  • pet-supplies
  • phone
  • skin-care
  • sport
  • tops-blouses
  • toys-hobbies
  • travel
  • video-games
  • womens-clothing
  • womens-fragrances

Filter products that are categorized as computers:

categories:computers

Site Filters

Parameter
Description
Example

site

Limit the results to a specific site or sites.

Limit the results to posts from Walmart or eBay:
(site:walmart.com OR site:ebay.com)

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 products from sites from Germany:
country:DE

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

Product Rating/Reviews Filters

Parameter
Description
Example

aggregated_rating

The average rating based on multiple ratings or reviews (between 0.0 and 5.0)

Return products with aggregated rating higher than 3.5:

aggregated_rating:>3.5

best_rating

The highest rating value the product got

Return products with highest rating of 5:

best_rating:5

worst_rating

The lowest rating value the product got

Return products with worst rating of 1:

worst_rating:1

reviews_count

The number of reviews a product got

Return products that got more than 10 reviews:

reviews_count:>10

Filters Reference