You.com icon

You.com

Search the web, extract content from URLs, get answers with citations, run multi-step research, and manage background research tasks using You.com APIs

Actions6

Web Search

AI-generated

Summary

Perform a web and news search using You.com with a specified query and various optional filters to control result scope, content extraction, and presentation.

Inputs

  • Query (required) — The search query string supporting operators like site:, filetype:, +, -, AND, OR, NOT.
  • Web Search Options — Optional settings including Boost Domains, Exclude Domains, Include Domains (mutually exclusive sets), count of results, country focus, crawl timeout for page content extraction, extraction mode and source, freshness filter by recency, knowledge data inclusion, language of results, pagination offset, and safe search content filtering.

Output shape

A JSON object containing search results from You.com API, including web results, news, and optionally knowledge results and extracted contents per each result depending on extraction options.

The output includes raw search results with structure depending on extraction mode: highlights mode returns query-relevant excerpts, full_page mode returns full HTML/Markdown content. The maximum number of results per section (web, news) and offset for pagination can be controlled. Domain filters must obey mutually exclusive rules. Errors can be returned per item if continue on fail is enabled.

Examples

Example 1: Search for PDF documents about AI on github.com

Set Query to 'AI site:github.com filetype:pdf' with default options to get up to 10 results with query highlights and moderate safe search filter.

Links

Discussion