Skip to main content
GET
Returns a list of search index hits from query
Before You Get StartedGet a free API Key at you.com/platform

Search Operators

Authorizations

X-API-Key
string
header
required

The unique API Key required to authorize API access. Learn how to get yours in the “Get your API key” section of the documentation.

Query Parameters

query
string
required

Search query used to retrieve relevant results from index. You may also include search operators to refine your search.

num_web_results
integer

Specifies the maximum number of web results to return. Range 1 ≤ num_web_results ≤ 100.

freshness
string

Specifies the freshness of the results to return. Provide either one of day, week, month, year, or a date range string in the format YYYY-MM-DDtoYYYY-MM-DD.

offset
integer

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
string

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'].

safesearch
string

Configures the safesearch filter for content moderation. off - no filtering applied.moderate - moderate content filtering (default). strict - strict content filtering.

Response

200 - application/json

A JSON object containing search results

hits
object[]
latency
number

Indicates the time (in seconds) taken by the API to generate the response.

Example:

1