Build with search and inference APIs for AI.
Search the web, extract content, generate cited answers, and conduct deep research. Or access leading AI models through our Inference Router API.
from youdotcom import Youfrom youdotcom.models import Country, Extraction, ExtractionMode, Freshnesswith You() as you:response = you.search(query="Nvidia latest quarterly revenue",count=2,freshness=Freshness.YEAR,country=Country.US,language="EN",include_domains=["nvidianews.nvidia.com", "reuters.com", "sec.gov"],knowledge="core",extraction=Extraction(extraction_mode=ExtractionMode.HIGHLIGHTS,highlights={"total_max_tokens": 1024},),)for item in response.results.knowledge or []:if item.type == "answer":sources = ", ".join(s.name for s in item.attribution)print(f"{item.title} ({sources}, as of {item.as_of or 'date unavailable'})")print(f" {item.description}\n")for result in response.results.web or []:print(f"{result.title} — {result.url}")if result.contents and result.contents.highlights:for highlight in result.contents.highlights:print(f" - {highlight}")
try it free
Connect Your Agent
Give your agent access to the live web. Start for free without an account or API key.
Claude Code
claude mcp add --transport http youdotcom "https://api.you.com/mcp/free"
the platform
One Platform for Search and Inference
Compose search, research, and inference APIs to build complex agentic workflows.
Web Search APIReturns real-time, LLM-ready web and news resultsInference Router APINEWLeading open-weight models through one API, grounded in real-time web searchExtract APINEWFetches any webpage or PDF and parses into clean Markdown or HTMLAnswer APIReturns a cited, synthesized answer from a single queryResearch APIAgentic multi-step research with cited synthesisFinance Research APIAgentic research, focused on financial and numerical data
integrate anywhere
Use With the Best Tools and Frameworks
resources
Developer Resources
API reference, agent tooling, and the Python SDK.
Web Search APIsEndpoints, parameters, and response schemas, with an interactive playgroundBuild with your agentMCP servers, skills, and harnesses for Claude Code, Cursor, Codex, and morePython SDKTyped Python client for the Web Search, Extract, Contents, Answer, Research, and Finance Research APIs, plus the CLI and OpenAPI specs
Start buildingCreate a key on the You.com Platform. The code samples on this page read it from YDC_API_KEY.Get API key