# You.com | Documentation

> 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 a complete documentation index, see https://you.com/docs/llms.txt
- 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): 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 Search API, Contents API, Research API, live crawling, evaluation, and pricing — everything you need to evaluate You.com.
- [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 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 Search API](https://you.com/docs/guides/evaluate-us.md): A practical guide to benchmarking You.com's 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 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 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/all.md): Explore ready-to-run sample apps built on You.com APIs — simple search, private RAG, and research. Each with a live demo and forkable GitHub repo.
- [Private RAG](https://you.com/docs/examples/private-rag.md): Build a private RAG system that answers questions about your own documents. Uses on-device embeddings and You.com for generation.
- [Web Search](https://you.com/docs/examples/simple-search.md): Web Search Example | You.com
- [Research](https://you.com/docs/examples/research.md): Get thorough, well-cited answers to complex questions using the You.com Research API. Live demo and forkable GitHub repo.
- [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.
- [Python SDK](https://you.com/docs/sdks/python-sdk.md): Official Python SDK for You.com's 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 Search, Contents, and Research APIs. Fully typed, simple to use — get started in minutes.
- [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 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.
- [Developer guide](https://you.com/docs/guides/developer-guide.md): Essential resources for You.com developers, including SDKs, MCP integration, error handling, and support channels.
- [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

- Search [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)