Skip to main content
You.com logo
  • 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

Slug: YOUSEARCH_CREATE_FINANCE_RESEARCHCreate 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_CREATE_RESEARCHRun 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

string
required
Nonblank research question or task, up to 40,000 characters.
boolean
Queue work and return a task handle. Supported only for deep, exhaustive, and frontier; required for frontier.
object
Arbitrary supported JSON Schema requesting structured object content; unavailable with lite.
object
Beta controls for domains, recency, and country.
string ("lite" | "standard" | "deep" | "exhaustive" | "frontier")
Effort tier: lite, standard, deep, exhaustive, or frontier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_FETCH_CONTENTSFetch 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

array
required
One to ten absolute webpage URLs to fetch. Each fetched page currently costs $1 per 1,000 pages.
array
Content representations to return: html, markdown, and/or metadata. Include metadata for JSON-LD and OpenGraph information when available.
integer
Maximum acceptable cached-content age in seconds. Use 0 to force a fresh fetch; omit for no age limit.
integer
Maximum seconds to wait for each page, from 1 through 60. Defaults to 10.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_GET_ACCOUNT_BALANCEReturn 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_GET_ANSWERSynthesize 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

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.
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.
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.
string
Result recency: day, week, month, year, or a YYYY-MM-DDtoYYYY-MM-DD date range.
string ("off" | "moderate" | "strict")
Explicit-content filter: off, moderate, or strict. Defaults to moderate.
array
Up to 500 domains to prefer in ranking without excluding other results. Can be combined with exclude_domains, but not include_domains.
array
Up to 500 domains to exclude. Can be combined with boost_domains, but not include_domains.
array
Up to 500 domains to use as a strict allowlist. Cannot be combined with exclude_domains or boost_domains.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_GET_RESEARCH_TASKPoll 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

string
required
Background research task UUID returned by the create action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_SEARCH_IMAGESSearch 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

integer
Maximum number of image results to return, from 1 to 100.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUSEARCH_YOU_SEARCHSearch 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

integer
Maximum number of search results to return per section (web/news). Valid range: 1-20.
string
required
Search query string. Supports search operators for refined searches.
integer
Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.
string
Country code for localized results (ISO 3166-1 alpha-2 format).
string
Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA).
string
Filter results by recency. Options: ‘day’, ‘week’, ‘month’, ‘year’, or date range in format ‘YYYY-MM-DDtoYYYY-MM-DD’.
string
Content filtering level. Options: ‘off’, ‘moderate’, ‘strict’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not