- 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
Create You.com Finance Research
Create You.com Finance Research
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
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 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
Create You.com Research
Create You.com Research
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
Queue work and return a task handle. Supported only for deep, exhaustive, and frontier; required for frontier.
Effort tier: lite, standard, deep, exhaustive, or frontier.
Output
Fetch Webpage Contents
Fetch Webpage Contents
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
One to ten absolute webpage URLs to fetch. Each fetched page currently costs $1 per 1,000 pages.
Content representations to return: html, markdown, and/or metadata. Include metadata for JSON-LD and OpenGraph information when available.
Maximum acceptable cached-content age in seconds. Use 0 to force a fresh fetch; omit for no age limit.
Output
Get Account Balance
Get Account Balance
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
Get Citation-Backed Answer
Get Citation-Backed Answer
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
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.
Explicit-content filter: off, moderate, or strict. Defaults to moderate.
Up to 500 domains to prefer in ranking without excluding other results. Can be combined with exclude_domains, but not include_domains.
Up to 500 domains to use as a strict allowlist. Cannot be combined with exclude_domains or boost_domains.
Output
Get You.com Research Task
Get You.com Research Task
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
Output
Search You.com Images (Beta)
Search You.com Images (Beta)
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
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
You.com Web Search
You.com Web Search
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 searchInput Parameters
Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.
Filter results by recency. Options: ‘day’, ‘week’, ‘month’, ‘year’, or date range in format ‘YYYY-MM-DDtoYYYY-MM-DD’.