# 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 full documentation content in one file, see https://you.com/docs/llms-full.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.mdx): 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.mdx): 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 overview](https://you.com/docs/search/overview.mdx): Get structured, LLM-optimized search results from web and news sources. Perfect for AI agents, RAG applications, and real-time information retrieval. - [Get live news](https://you.com/docs/search/live-news.mdx): 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/search/retrieve-page-content.mdx): 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/search/search-operators.mdx): Discover the search operators and learn how to use them - [How to Evaluate You.com Search API](https://you.com/docs/search/evaluate-us.mdx): A practical guide to benchmarking You.com's Search API: methodology, configurations, datasets, and real performance tradeoffs. - [Contents API Overview](https://you.com/docs/contents/overview.mdx): 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/research/overview.mdx): 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/finance-research/overview.mdx): 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. - [Account](https://you.com/docs/administration/account.mdx): 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.mdx): Manage your You.com billing, view usage and credits, add funds, and handle payment methods. - [API Keys](https://you.com/docs/administration/api-keys.mdx): Learn how to create, manage, rotate, and secure your You.com API keys. - [Examples](https://you.com/docs/examples/all.mdx): 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.mdx): 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.mdx): Web Search Example | You.com - [Research](https://you.com/docs/examples/research.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): Add real-time web search to LangChain agents and RAG pipelines using the langchain-youdotcom package. - [LangGraph](https://you.com/docs/integrations/langgraph.mdx): 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.mdx): 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.mdx): 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.mdx): 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.mdx): Add real-time web search and webpage content extraction to Vercel AI SDK applications. - [Zapier](https://you.com/docs/integrations/zapier.mdx): 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.mdx): 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.mdx): 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.mdx) - Contents [Contents](https://you.com/docs/api-reference/contents.mdx) - Research [Research](https://you.com/docs/api-reference/research/v1-research.mdx) - Finance Research [Finance Research](https://you.com/docs/api-reference/finance-research/v1-finance_research.mdx) - Billing [Account Balance](https://you.com/docs/api-reference/billing/get-account-balance.mdx) - Live News [Live News](https://you.com/docs/custom-solutions/live-news/live-news.mdx) - Images [Images](https://you.com/docs/custom-solutions/images/images.mdx) - Express Agent [Express Agent](https://you.com/docs/custom-solutions/agents/express-agent/express-agent-runs.mdx) - Custom Agent [Custom Agent](https://you.com/docs/custom-solutions/agents/custom-agent/custom-agent-runs.mdx) - Advanced Agent [Advanced Agent](https://you.com/docs/custom-solutions/agents/advanced-agent/advanced-agent-runs.mdx) ## 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)