/v2/search
endpoint instead of /search
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
A unique API Key required to authorize API access. Ensure it is kept confidential. Get a free API Key at you.com/platform.
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 results to return per section. Range 1 ≤ count ≤ 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 count
. For example, if count = 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.
Indicates which set(s) of search results to livecrawl and return full page content.
web
, news
, all
Indicates the format of the livecrawled content.
html
, markdown
Response
A JSON object containing unified search results from web and news sources
The response is of type object
.