Skip to main content
Filters narrow the results of a search by site, time, place, language and safety. Send them next to query.

Search selected sites

Get an API key in the Quickstart. This request searches two sites and keeps results from the past year.

Read the response

Every result is on one of the sites you named. This real response is cut to a shorter description for each row.
A filter can leave fewer results than limit. A call that returns nothing costs nothing and carries a warning.

Search from a place

location and lang steer which pages come back. This request searches from Berlin and asks for German pages.
This real response is cut to two of the three rows.
lang steers which pages come back, but some results can still be in other languages.

Options

A filter sent at the top level applies to every source it fits. To give web results their own tbs, location, country or lang, send the web source as an object: "sources": [{ "type": "web", "tbs": "qdr:w", "country": "de" }]. See Sources.

Time window

Join values with a comma, such as sbd:1,qdr:w for the past week, newest first.

Limits and errors

  • includeDomains together with excludeDomains returns 400 invalidRequest. The error says Send includeDomains or excludeDomains, not both.
  • A tbs that is not in the table returns 400 invalidRequest, and the error names the part it did not understand. qdr takes d, w, m or y, and cd_min must be on or before cd_max.
  • A date range (cdr) with news in sources returns 400 invalidRequest. The error says News takes qdr and sbd only.
  • tbs with only images in sources returns 400 invalidRequest. The error says Image results cannot be filtered by time. Leave tbs out or drop images. With other sources, images are left unfiltered and warning says so.
  • A location that does not end in a country returns 400 invalidRequest. The error says Send a place that ends with a country, like Berlin,Germany or Germany, or use country.
  • A country other than us with images in sources returns 400 invalidRequest, because image results are always from the US.
  • With categories of research and web in sources, includeDomains and excludeDomains return 400 invalidRequest, because research already limits the search to academic sites.