# You.com | Documentation

> Web Search, Contents, and Research APIs that give your AI app real-time web intelligence. Start with free credits.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://you.com/docs/_mcp/server

## Docs

- [Build agentic apps with real-time web intelligence.](https://you.com/docs/welcome.md): Web Search, Contents, and Research APIs that give your AI app real-time web intelligence. Start with free credits — no credit card required.
- [Quickstart](https://you.com/docs/quickstart.md): Get from zero to working API requests in minutes. Covers the Web Search API, Contents API, Research API, Finance Research API, live crawling, evaluation, and pricing — everything you need to evaluate You.com.
- [Web Search API Overview](https://you.com/docs/guides/search.md): Get structured, LLM-optimized search results from web and news sources. Perfect for AI agents, RAG applications, and real-time information retrieval.
- [Contents API Overview](https://you.com/docs/guides/contents.md): Extract clean HTML or Markdown content from any webpage on demand. Perfect for competitive intelligence, knowledge base ingestion, and web scraping without the mess.
- [Research API Overview](https://you.com/docs/guides/research.md): Get thorough, well-cited answers to complex questions. The Research API runs multiple searches, reads through sources, and returns Markdown or structured JSON with citations.
- [Finance Research API Overview](https://you.com/docs/guides/finance-research.md): Get thorough, well-cited answers to financial questions. The Finance Research API uses a finance-optimized index to research earnings, filings, market data, and more — at the same price and latency as the Research API.
- [Get live news](https://you.com/docs/guides/live-news.md): Retrieve real-time news results from the You.com Web Search API. Filter by recency, country, language, and more.
- [Retrieve page content](https://you.com/docs/guides/retrieve-page-content.md): Live-crawl search results to get full HTML or Markdown page content. Ideal for RAG, knowledge base construction, and deep content analysis.
- [Search operators](https://you.com/docs/guides/search-operators.md): Discover the search operators and learn how to use them
- [How to Evaluate You.com Web Search API](https://you.com/docs/guides/evaluate-us.md): A practical guide to benchmarking You.com's Web Search API: methodology, configurations, datasets, and real performance tradeoffs.
- [The Best Web Search API for AI Agents](https://you.com/docs/capabilities/web-search-api-for-ai-agents.md): The You.com Web Search API is built for AI agents, assistants, coding copilots, and RAG pipelines. Structured snippets, real-time web, one endpoint.
- [MCP Server for Web Search](https://you.com/docs/capabilities/mcp-server-for-web-search.md): Add real-time web search to Claude, Cursor, and any MCP-compatible client with the You.com MCP server. One-line install, structured results, no scraping.
- [The Best API for Grounding LLM Responses with Citations](https://you.com/docs/capabilities/grounding-llm-responses-with-citations.md): Add citations and real-time source grounding to any LLM with the You.com Web Search API. Step-by-step guide with code, schema, and production patterns.
- [Account](https://you.com/docs/administration/account.md): Learn how to create, manage, and configure your You.com API account, including profile settings, email and password management.
- [Billing](https://you.com/docs/administration/billing.md): Manage your You.com billing, view usage and credits, add funds, and handle payment methods.
- [API Keys](https://you.com/docs/administration/api-keys.md): Learn how to create, manage, rotate, and secure your You.com API keys.
- [Examples](https://you.com/docs/examples.md): Explore real-world use cases powered by You.com APIs.
- [Simple Search](https://you.com/docs/examples/simple-search.md): Your first API call in 2 minutes — fetch real-time web results in under 20 lines.
- [Deep Search](https://you.com/docs/examples/deep-search.md): Multi-pass query expansion that surfaces sources a single search would miss.
- [Research Agent](https://you.com/docs/examples/research.md): A multi-step agent that plans, searches, reads, and writes a cited report.
- [Biomedical Research Brief](https://you.com/docs/examples/biomedical-research.md): Use the Research API to assemble a cited brief on any drug, target, or disease.
- [Contents Extraction](https://you.com/docs/examples/contents.md): Pull clean Markdown or HTML from any URL — ideal for LLM ingestion.
- [Deep Research Skill](https://you.com/docs/examples/deep-research.md): An Agent Skill for multi-source synthesis with citations preserved.
- [Competitive Intel Skill](https://you.com/docs/examples/competitive-intel.md): An Agent Skill that turns company or market research into a structured brief.
- [News & Events Skill](https://you.com/docs/examples/news-events.md): An Agent Skill for recent, time-bounded, cited retrieval.
- [Fact Check Skill](https://you.com/docs/examples/fact-check.md): An Agent Skill that checks a claim against supporting and contradicting evidence.
- [Financial Research Skill](https://you.com/docs/examples/financial-research.md): An Agent Skill for filings, fundamentals, market data, and ticker comparisons.
- [Research Recipe Skill](https://you.com/docs/examples/research-recipe.md): A copy-and-customize template for composing You.com research Skills.
- [SDKs & tools overview](https://you.com/docs/integrations-overview.md): You.com meets your agents wherever they run — MCP clients, Python and TypeScript codebases, Claude Skills, and the major agent frameworks.
- [MCP Server](https://you.com/docs/build-with-agents/mcp-server.md): Integrate You.com's powerful web access capabilities into your agentic IDE using the Model Context Protocol (MCP). Search, extract content, research, and get finance-grade answers. Quick setup for Claude Code, Cursor, VS Code, and more.
- [Agent Skills](https://you.com/docs/build-with-agents/skills.md): Install pre-built agent skills to integrate You.com's web search and content extraction into your framework of choice—Vercel AI SDK, Claude, OpenAI, crewAI, CLI and more.
- [Codex CLI](https://you.com/docs/build-with-agents/agent-harnesses/codex-cli.md): Give Codex CLI real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup.
- [Claude Code](https://you.com/docs/build-with-agents/agent-harnesses/claude-code.md): Give Claude Code real-time web search, content extraction, and citation-backed research through the You.com MCP Server. OAuth 2.1 or free tier.
- [Cursor](https://you.com/docs/build-with-agents/agent-harnesses/cursor.md): Give Cursor real-time web search, content extraction, and citation-backed research through the You.com MCP Server. One-click install or manual config.
- [OpenCode](https://you.com/docs/build-with-agents/agent-harnesses/opencode.md): Give OpenCode real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup.
- [Windsurf](https://you.com/docs/build-with-agents/agent-harnesses/windsurf.md): Give Windsurf's Cascade agent real-time web search, content extraction, and citation-backed research through the You.com MCP Server.
- [Gemini CLI](https://you.com/docs/build-with-agents/agent-harnesses/gemini-cli.md): Give Gemini CLI real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup.
- [VS Code](https://you.com/docs/build-with-agents/agent-harnesses/vscode.md): Give GitHub Copilot's agent mode real-time web search, content extraction, and citation-backed research through the You.com MCP Server.
- [JetBrains IDEs](https://you.com/docs/build-with-agents/agent-harnesses/jetbrains.md): Give AI Assistant and Junie real-time web search, content extraction, and citation-backed research through the You.com MCP Server.
- [Zed](https://you.com/docs/build-with-agents/agent-harnesses/zed.md): Give Zed's AI assistant real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup.
- [Pi](https://you.com/docs/build-with-agents/agent-harnesses/pi.md): Give Pi real-time web search and content extraction through the You.com agent skills. Free tier with no signup.
- [Python SDK](https://you.com/docs/sdks/python-sdk.md): Official Python SDK for You.com's Web Search, Contents, and Research APIs. Simple, predictable API access with type hints and async support — get started in minutes.
- [TypeScript SDK](https://you.com/docs/sdks/typescript-sdk.md): Official TypeScript SDK for You.com's Web Search, Contents, and Research APIs. Fully typed, simple to use — get started in minutes.
- [Integrations](https://you.com/docs/integrations.md): Connect You.com's Web Search, Contents, and Research APIs to the AI frameworks, automation platforms, and open models your agents already run on.
- [crewAI](https://you.com/docs/integrations/crewai.md): Add real-time web search, research, and content extraction to crewAI agents through You.com's remote MCP server.
- [LangChain](https://you.com/docs/integrations/langchain.md): Add real-time web search to LangChain agents and RAG pipelines using the langchain-youdotcom package.
- [LangGraph](https://you.com/docs/integrations/langgraph.md): Build stateful AI agents with real-time web search and content extraction using LangGraph and the langchain-youdotcom package.
- [n8n](https://you.com/docs/integrations/n8n.md): Add real-time web search and content extraction to n8n workflows using the @youdotcom-oss/n8n-nodes-youdotcom community node.
- [LlamaIndex](https://you.com/docs/integrations/llamaindex.md): Use You.com's Web Search API as a retriever in LlamaIndex applications with the llama-index-retrievers-you package.
- [OpenAI GPT OSS](https://you.com/docs/integrations/gpt-oss.md): You.com powers the default web browsing backend for OpenAI's open-weight GPT OSS models. Use YouComBackend to give GPT OSS models real-time web access.
- [Vercel AI SDK](https://you.com/docs/integrations/vercel-ai-sdk.md): Add real-time web search and webpage content extraction to Vercel AI SDK applications.
- [Zapier](https://you.com/docs/integrations/zapier.md): Connect You.com's Search, Content, and News APIs to 8,000+ apps in Zapier — no code required. Automate research, content, and data-collection workflows.
- [Partnerships](https://you.com/docs/partnerships.md): You.com is available across MCP marketplaces, cloud marketplaces, AI frameworks, and developer tools.
- [MCP Marketplaces](https://you.com/docs/partnerships/mcp-marketplaces.md): Find You.com MCP listings across Databricks Marketplace, the Anthropic MCP Registry, PulseMCP, Glama, MCP Market, and Composio.
- [Cloud Marketplaces](https://you.com/docs/partnerships/cloud-marketplaces.md): Procure You.com Web Search, Research, and Finance Research APIs through AWS Marketplace and Microsoft Azure Marketplace.
- [Framework and Tool Partners](https://you.com/docs/partnerships/framework-tool-partners.md): Explore You.com partner listings across OpenAI GPT OSS, LangChain, LangGraph, Zapier, Vercel AI SDK, n8n, LlamaIndex, crewAI, LiteLLM, and more.
- [Errors](https://you.com/docs/error-handling/error-code-reference.md): Complete reference for You.com API errors and HTTP status codes. Understand 401, 402, 403, 404, 429, and 500 errors with causes and recommended actions.

## API Docs

- Web Search API [Search](https://you.com/docs/api-reference/search/v1-search.md)
- Contents [Contents](https://you.com/docs/api-reference/contents.md)
- Research [Research](https://you.com/docs/api-reference/research/v1-research.md)
- Finance Research [Finance Research](https://you.com/docs/api-reference/finance-research/v1-finance_research.md)
- Billing [Account Balance](https://you.com/docs/api-reference/billing/get-account-balance.md)
- Live News [Live News](https://you.com/docs/custom-solutions/live-news/live-news.md)
- Images [Images](https://you.com/docs/custom-solutions/images/images.md)
- Express Agent [Express Agent](https://you.com/docs/custom-solutions/agents/express-agent/express-agent-runs.md)
- Custom Agent [Custom Agent](https://you.com/docs/custom-solutions/agents/custom-agent/custom-agent-runs.md)
- Advanced Agent [Advanced Agent](https://you.com/docs/custom-solutions/agents/advanced-agent/advanced-agent-runs.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://you.com/openapi.json)
- [OpenAPI YAML](https://you.com/openapi.yaml)