|
| 1 | +--- |
| 2 | +title: You.com |
| 3 | +description: Web search and research with You.com |
| 4 | +--- |
| 5 | + |
| 6 | +import { BlockInfoCard } from "@/components/ui/block-info-card" |
| 7 | + |
| 8 | +<BlockInfoCard |
| 9 | + type="you" |
| 10 | + color="#0B0B0F" |
| 11 | +/> |
| 12 | + |
| 13 | +{/* MANUAL-CONTENT-START:intro */} |
| 14 | +[You.com](https://you.com) provides web search APIs built for AI, letting agents search the web, extract clean content, and generate grounded, well-cited answers from real-time results. Its APIs go beyond a single query, returning clean web and news results, full-page content extraction, and multi-step research with cited sources, including a dedicated mode for financial topics. |
| 15 | + |
| 16 | +With You.com, you can: |
| 17 | + |
| 18 | +- **Search the web and news**: Retrieve fresh, ranked web and news results with titles, URLs, descriptions, and query-relevant snippets |
| 19 | +- **Extract clean page content**: Pull Markdown, HTML, and structured metadata from one or many URLs in a single call |
| 20 | +- **Run agentic research**: Pose a complex question and get a synthesized, well-cited answer that autonomously runs multiple searches and reads across sources |
| 21 | +- **Research financial topics**: Generate cited answers grounded in SEC filings, earnings reports, and company financials |
| 22 | +- **Target and filter results**: Constrain by domain allowlists or blocklists, freshness windows, country, and language, and use search operators like `site:`, `filetype:`, and boolean logic |
| 23 | +- **Tune depth versus speed**: Pick a research effort level (lite, standard, deep, or exhaustive) to balance latency against thoroughness |
| 24 | + |
| 25 | +In Sim, the You.com integration lets your agents search, read, and research the web programmatically. This powers automations such as real-time market and competitor monitoring, lead and account enrichment, content extraction pipelines, and cited research briefs, all as part of your workflows. |
| 26 | +{/* MANUAL-CONTENT-END */} |
| 27 | + |
| 28 | + |
| 29 | +## Usage Instructions |
| 30 | + |
| 31 | +Search the web for real-time, LLM-ready results, extract clean content from any URL, and run web or finance research that returns grounded, well-cited answers. |
| 32 | + |
| 33 | + |
| 34 | + |
| 35 | +## Actions |
| 36 | + |
| 37 | +### `you_search` |
| 38 | + |
| 39 | +Search the web with You.com. Returns LLM-ready web and news results with titles, URLs, descriptions, and query-relevant snippets. |
| 40 | + |
| 41 | +#### Input |
| 42 | + |
| 43 | +| Parameter | Type | Required | Description | |
| 44 | +| --------- | ---- | -------- | ----------- | |
| 45 | +| `query` | string | Yes | The search query. Supports operators: site:domain.com, filetype:pdf, +term, -term, AND/OR/NOT, lang:en | |
| 46 | +| `count` | number | No | Maximum number of results per section \(1-100, default: 10\) | |
| 47 | +| `offset` | number | No | Pagination offset \(0-9, default: 0\) | |
| 48 | +| `freshness` | string | No | Freshness filter: day, week, month, year, or a YYYY-MM-DDtoYYYY-MM-DD range | |
| 49 | +| `country` | string | No | Two-letter country code to localize results \(e.g., US, GB, JP\) | |
| 50 | +| `language` | string | No | BCP 47 language code \(e.g., EN, FR, DE\). Default: EN | |
| 51 | +| `safesearch` | string | No | Safe search filter level: off, moderate, or strict | |
| 52 | +| `livecrawl` | string | No | Live-crawl sections for full page content: web, news, or all | |
| 53 | +| `include_domains` | string | No | Comma-separated allowlist of domains \(mutually exclusive with exclude_domains\) | |
| 54 | +| `exclude_domains` | string | No | Comma-separated blocklist of domains to exclude from results | |
| 55 | +| `apiKey` | string | Yes | You.com API Key | |
| 56 | + |
| 57 | +#### Output |
| 58 | + |
| 59 | +| Parameter | Type | Description | |
| 60 | +| --------- | ---- | ----------- | |
| 61 | +| `search_uuid` | string | Unique identifier for this search request | |
| 62 | +| `web` | array | Web search results | |
| 63 | +| ↳ `url` | string | The URL of the result | |
| 64 | +| ↳ `title` | string | The title of the result | |
| 65 | +| ↳ `description` | string | Brief summary of the page | |
| 66 | +| ↳ `snippets` | array | Query-relevant text excerpts from the page | |
| 67 | +| ↳ `page_age` | string | Publication timestamp \(ISO 8601\) | |
| 68 | +| ↳ `author` | string | Primary content author | |
| 69 | +| ↳ `favicon_url` | string | URL of the site's favicon | |
| 70 | +| ↳ `thumbnail_url` | string | Preview image URL | |
| 71 | +| ↳ `contents` | json | Full page content \(only when livecrawl is enabled\) | |
| 72 | +| `news` | array | News search results | |
| 73 | +| ↳ `url` | string | The URL of the article | |
| 74 | +| ↳ `title` | string | The article headline | |
| 75 | +| ↳ `description` | string | Content summary | |
| 76 | +| ↳ `page_age` | string | Publication timestamp \(UTC\) | |
| 77 | +| ↳ `thumbnail_url` | string | Preview image URL | |
| 78 | +| ↳ `contents` | json | Full page content \(only when livecrawl is enabled\) | |
| 79 | + |
| 80 | +### `you_contents` |
| 81 | + |
| 82 | +Extract clean page content from one or more URLs with You.com. Returns Markdown and/or HTML plus structured metadata for each page. |
| 83 | + |
| 84 | +#### Input |
| 85 | + |
| 86 | +| Parameter | Type | Required | Description | |
| 87 | +| --------- | ---- | -------- | ----------- | |
| 88 | +| `urls` | string | Yes | Comma-separated list of webpage URLs to extract content from \(up to 100\) | |
| 89 | +| `format` | string | No | Output format: markdown \(default\), html, or both | |
| 90 | +| `crawl_timeout` | number | No | Maximum seconds to wait per page \(1-60, default: 10\) | |
| 91 | +| `apiKey` | string | Yes | You.com API Key | |
| 92 | + |
| 93 | +#### Output |
| 94 | + |
| 95 | +| Parameter | Type | Description | |
| 96 | +| --------- | ---- | ----------- | |
| 97 | +| `results` | array | Extracted content for each requested URL | |
| 98 | +| ↳ `url` | string | The webpage URL | |
| 99 | +| ↳ `title` | string | The page title | |
| 100 | +| ↳ `markdown` | string | Markdown content \(if requested\) | |
| 101 | +| ↳ `html` | string | HTML content \(if requested\) | |
| 102 | +| ↳ `metadata` | json | Structured metadata \(site_name, favicon_url\) for each page | |
| 103 | + |
| 104 | +### `you_research` |
| 105 | + |
| 106 | +Run agentic web research with You.com. Takes a complex question, autonomously runs multiple searches, reads sources, and returns a synthesized, well-cited Markdown answer. |
| 107 | + |
| 108 | +#### Input |
| 109 | + |
| 110 | +| Parameter | Type | Required | Description | |
| 111 | +| --------- | ---- | -------- | ----------- | |
| 112 | +| `input` | string | Yes | The research question or complex query \(up to 40,000 characters\) | |
| 113 | +| `research_effort` | string | No | Depth of research: lite \(fastest\), standard \(default\), deep, or exhaustive \(most thorough\) | |
| 114 | +| `apiKey` | string | Yes | You.com API Key | |
| 115 | + |
| 116 | +#### Output |
| 117 | + |
| 118 | +| Parameter | Type | Description | |
| 119 | +| --------- | ---- | ----------- | |
| 120 | +| `content` | string | The synthesized research answer \(Markdown with inline citations\) | |
| 121 | +| `content_type` | string | Type of the content field: text or object | |
| 122 | +| `sources` | array | Web sources used to generate the answer | |
| 123 | +| ↳ `url` | string | The source URL | |
| 124 | +| ↳ `title` | string | The source title | |
| 125 | +| ↳ `snippets` | array | Relevant snippets extracted from the source | |
| 126 | + |
| 127 | +### `you_finance` |
| 128 | + |
| 129 | +Run agentic financial research with You.com. Returns a synthesized, well-cited answer drawn from SEC filings, earnings reports, and company financials. |
| 130 | + |
| 131 | +#### Input |
| 132 | + |
| 133 | +| Parameter | Type | Required | Description | |
| 134 | +| --------- | ---- | -------- | ----------- | |
| 135 | +| `input` | string | Yes | The finance research question \(up to 40,000 characters\) | |
| 136 | +| `research_effort` | string | No | Depth of research: deep \(default\) or exhaustive \(most thorough\) | |
| 137 | +| `apiKey` | string | Yes | You.com API Key | |
| 138 | + |
| 139 | +#### Output |
| 140 | + |
| 141 | +| Parameter | Type | Description | |
| 142 | +| --------- | ---- | ----------- | |
| 143 | +| `content` | string | The synthesized finance research answer \(Markdown with inline citations\) | |
| 144 | +| `content_type` | string | Type of the content field: text or object | |
| 145 | +| `sources` | array | Financial sources used to generate the answer | |
| 146 | +| ↳ `url` | string | The source URL | |
| 147 | +| ↳ `title` | string | The source title | |
| 148 | +| ↳ `snippets` | array | Relevant snippets extracted from the source | |
| 149 | + |
| 150 | + |
0 commit comments