Search
Before You Get Started
To register for usage of our Search API, please reach out via email at api@you.com.
Search Operators
Operator | Description | Example |
---|---|---|
site | Searches for webpages from a particular domain (including subdomains) | site:uscourts.gov USA v. Enron |
filetype | Searches for webpages that are of the specified file type | USA v. Enron filetype:pdf |
lang | Searches for webpages that are in a particular language (ISO 639-1 format) | Modelo lang:es |
+ | Searches for webpages that contain the exact term after the + | Enron +GAAP |
- | Searches for webpages that do not contain the exact term after the - | guitar -prs |
AND | Logical operator to combine expressions | guitar +prs AND +silversky |
OR | Logical operator to combine expressions | guitar -prs AND -silversky |
NOT | Negation of expressions | USA v. Enron NOT site:uscourts.gov |
Authorizations
Query Parameters
Search query used to retrieve relevant results from index. You may also include search operators to refine your search.
Specifies the maximum number of web results to return. Range 1 ≤ num_web_results ≤ 20
.
Specifies the freshness of the results to return.
day
, week
, month
, year
Indicates the offset
for pagination. The offset
is calculated in multiples of num_web_results
. For example, if num_web_results = 5
and offset = 1
, results 5–10 will be returned. Range 0 ≤ offset ≤ 9
.
Country Code, one of ['AR', 'AU', 'AT', 'BE', 'BR', 'CA', 'CL', 'DK', 'FI', 'FR', 'DE', 'HK', 'IN', 'ID', 'IT', 'JP', 'KR', 'MY', 'MX', 'NL', 'NZ', 'NO', 'CN', 'PL', 'PT', 'PH', 'RU', 'SA', 'ZA', 'ES', 'SE', 'CH', 'TW', 'TR', 'GB', 'US']
.
Configures the safesearch filter for content moderation. off
- no filtering applied.moderate
- moderate content filtering (default). strict
- strict content filtering.