> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# You.com

> YouSearch is a search engine or search tool that enables users to find relevant information, possibly with enhanced filtering or privacy-focused features

![You.com logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/yousearch.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=f2d604180b76f50cadcfbeed8aafc348)

* **Category:** web search & research
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `YOUSEARCH`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Create You.com Finance Research
>
> **Slug:** `YOUSEARCH_CREATE_FINANCE_RESEARCH`
>
> Create citation-backed research over You.com's finance index, covering financial data, filings, analyst coverage, and news. Choose deep or exhaustive research effort; this tool accepts neither source controls nor a structured-output schema.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> Nonblank financial research question, up to 40,000 characters. The finance index covers company fundamentals, equity and commodity prices, private company data, alternative signals, macroeconomic indicators, SEC filings, analyst coverage, and financial news. source\_control and output\_schema are unsupported; use the general Research API when those controls are needed.
>
> **research\_effort** `string ("deep" | "exhaustive")`
>
> Research depth. deep is the default and costs \$110 per 1,000 calls with latency under 120 seconds; exhaustive costs \$500 per 1,000 calls with latency under 300 seconds. The default self-serve limit is 5 requests/second.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create You.com Research
>
> **Slug:** `YOUSEARCH_CREATE_RESEARCH`
>
> Run cited multi-step You.com research synchronously or create a background task. Synchronous and background submissions share the documented 10 requests/second limit; You.com does not publish a separate background-task concurrency cap. Effort pricing and typical latency per 1,000 calls are: lite \$12 and \<10s; standard \$50 and about 10-30s; deep \$100 and \<120s; exhaustive \$450 and \<300s; frontier \$1,200 and 30-12000s (p50 300s). Background mode supports deep, exhaustive, and frontier only, and is mandatory for frontier. Structured output supports arbitrary schemas within a restricted subset: object root, depth 5, 100 properties, 500 enum values, 7,500 large-enum string characters, and 25,000 total schema-string characters; all object properties must be required and additionalProperties must be false. Structured output is unavailable with lite.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> Nonblank research question or task, up to 40,000 characters.
>
> **background** `boolean`
>
> Queue work and return a task handle. Supported only for deep, exhaustive, and frontier; required for frontier.
>
> **output\_schema** `object`
>
> Arbitrary supported JSON Schema requesting structured object content; unavailable with lite.
>
> **source\_control** `object`
>
> Beta controls for domains, recency, and country.
>
> **research\_effort** `string ("lite" | "standard" | "deep" | "exhaustive" | "frontier")`
>
> Effort tier: lite, standard, deep, exhaustive, or frontier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Webpage Contents
>
> **Slug:** `YOUSEARCH_FETCH_CONTENTS`
>
> Fetch clean content for up to 10 known webpage URLs. Contents currently costs \$1 per 1,000 fetched pages and is limited to 10 requests per second on the documented self-serve plan.
>
> #### Input Parameters
>
> **urls** `array` *required*
>
> One to ten absolute webpage URLs to fetch. Each fetched page currently costs \$1 per 1,000 pages.
>
> **formats** `array`
>
> Content representations to return: html, markdown, and/or metadata. Include metadata for JSON-LD and OpenGraph information when available.
>
> **max\_age** `integer`
>
> Maximum acceptable cached-content age in seconds. Use 0 to force a fresh fetch; omit for no age limit.
>
> **crawl\_timeout** `integer`
>
> Maximum seconds to wait for each page, from 1 through 60. Defaults to 10.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Balance
>
> **Slug:** `YOUSEARCH_GET_ACCOUNT_BALANCE`
>
> Return the remaining You.com credit balance in cents. Personal API keys return the individual user's balance. API keys belonging to organization members return the organization's shared credit balance. You.com does not publish a separate numeric rate limit for this read-only endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Citation-Backed Answer
>
> **Slug:** `YOUSEARCH_GET_ANSWER`
>
> Synthesize a citation-backed answer from You.com web results. Answer currently costs \$5 per 1,000 calls and is limited to 10 requests per second on the documented self-serve plan.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Nonblank search question used to retrieve evidence and synthesize the answer (1-400 characters). Each answer currently costs \$5 per 1,000 calls.
>
> **country** `string ("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")`
>
> Supported country code controlling geographic focus.
>
> **language** `string ("AR" | "EU" | "BN" | "BG" | "CA" | "HR" | "CS" | "DA" | "NL" | "EN" | "EN-GB" | "ET" | "FI" | "FR" | "GL" | "DE" | "EL" | "GU" | "HE" | "HI" | "HU" | "IS" | "IT" | "KN" | "KO" | "LV" | "LT" | "MS" | "ML" | "MR" | "NB" | "PL" | "PA" | "RO" | "RU" | "SR" | "SK" | "SL" | "ES" | "SV" | "TA" | "TE" | "TH" | "TR" | "UK" | "VI")`
>
> Supported BCP 47 language tag for web results.
>
> **freshness** `string`
>
> Result recency: day, week, month, year, or a YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **safesearch** `string ("off" | "moderate" | "strict")`
>
> Explicit-content filter: off, moderate, or strict. Defaults to moderate.
>
> **boost\_domains** `array`
>
> Up to 500 domains to prefer in ranking without excluding other results. Can be combined with exclude\_domains, but not include\_domains.
>
> **exclude\_domains** `array`
>
> Up to 500 domains to exclude. Can be combined with boost\_domains, but not include\_domains.
>
> **include\_domains** `array`
>
> Up to 500 domains to use as a strict allowlist. Cannot be combined with exclude\_domains or boost\_domains.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get You.com Research Task
>
> **Slug:** `YOUSEARCH_GET_RESEARCH_TASK`
>
> Poll both status metadata and the final result of a background research task. This is the non-streaming polling operation: it returns queued/running/completed/ failed/cancelled status, timestamps, original input, and errors. `result` is null while work is in progress and contains the cited final answer once completed. It does not open the provider's SSE endpoint. Research is limited to 10 requests/second; callers should poll accordingly. Frontier tasks may take 30-12000s (p50 300s).
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Background research task UUID returned by the create action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search You.com Images (Beta)
>
> **Slug:** `YOUSEARCH_SEARCH_IMAGES`
>
> Search You.com Images. This endpoint is beta, unmaintained, and early-access-only; its response shape and availability may change without notice. You.com does not publish a price or numeric default rate limit for it. Large transformed thumbnails can return 403, so fall back to `thumbnail` or `image_url`. Do not build a production dependency on this action.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of image results to return, from 1 to 100.
>
> **query** `string` *required*
>
> Image search query. Supports operators such as site:, filetype:, and OR. The provider accepts whitespace-only queries and returns no results. This endpoint is beta, unmaintained, and early-access-only; its response shape and availability may change without notice.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] You.com Web Search
>
> **Slug:** `YOUSEARCH_YOU_SEARCH`
>
> Search the web using You.com's search API. Returns LLM-ready web results and news articles based on your query. Supports advanced filtering by country, language, freshness, and content safety.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.005 per web search
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of search results to return per section (web/news). Valid range: 1-20.
>
> **query** `string` *required*
>
> Search query string. Supports search operators for refined searches.
>
> **offset** `integer`
>
> Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.
>
> **country** `string`
>
> Country code for localized results (ISO 3166-1 alpha-2 format).
>
> **language** `string`
>
> Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA).
>
> **freshness** `string`
>
> Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'.
>
> **safesearch** `string`
>
> Content filtering level. Options: 'off', 'moderate', 'strict'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
