Youcom · Search

You.com / Web search

Ranked web and news results (title, url, description, snippets) for a query; count up to 100, offset 0-9 for pages, freshness, country, language, domain include/exclude/boost, and knowledge=core for live stock, crypto, weather and sports data. Full-page extraction is not offered here; use You.com / Page contents.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

boost_domains body · optional
A list of domains to boost in search ranking. Matching results from these domains receive a fixed relative ranking boost, but this is not a filter. If the boosted domains do not have matching results, results from other domains can still appear. Supports up to 500 domains. Can be combined with `exclude_domains`. Cannot be combined with `include_domains`. Passing both `boost_domains` and `include_domains` will return a `422` error.
count body · optional
Specifies the maximum number of search results to return per section (the sections are `web` and `news`. See the JSON response to visualize them).
country body · optional
The country code that determines the geographical focus of the web results.
exclude_domains body · optional
A list of domains to exclude from search results. Results from these domains will be filtered out. Supports up to 500 domains. Cannot be combined with `include_domains`; passing both will return a `422` error.
freshness body · optional
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`. When your search query includes a temporal keyword and you also set a freshness parameter, the search will use the broader (i.e., less restrictive) of the two timeframes. For example, if you use `query=news+this+week&freshness=month`, the results will use a freshness of month.
include_domains body · optional
A list of domains to restrict search results to. Only results from these domains will be returned. Supports up to 500 domains. This is a strict allowlist, not a boost — results are limited exclusively to the specified domains. Cannot be combined with `exclude_domains`; passing both will return a `422` error.
knowledge body · optional
Requests knowledge results alongside web and news search.
language body · optional
The language of the web results that will be returned (BCP 47 format).
offset body · optional
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`.
query body · required
The search query used to retrieve relevant results from the web. You can also include [search operators](https://you.com/docs/guides/search/search-operators) to refine your search.
safesearch body · optional
Configures the safesearch filter for content moderation. This allows you to decide whether to return NSFW content or not.

Provider docs How to run it