# Caesar

> The search engine for AI: web search and full-document reads across HTTP, SDKs, CLI, MCP, and Skills.

## Docs

- [Caesar](https://docs.trycaesar.com/index.md): Caesar is the search engine for AI, organising the world's data with an API for web search and full-document reads.
- [Connect Caesar to your agent](https://docs.trycaesar.com/quickstart.md): Sign up for Caesar, install search into an agent, verify search and read, then see the raw API loop.
- [Authentication](https://docs.trycaesar.com/authentication.md): Bearer API keys, scopes, and key-handling conventions for the Caesar API.
- [Pricing](https://docs.trycaesar.com/pricing.md): Caesar search uses account credits for API usage, with a limited-time $1,000 starting credit grant for new accounts.
- [Rate limits](https://docs.trycaesar.com/rate-limits.md): Per-second API-key rate limits, the X-RateLimit response headers, and how to back off on 429s.
- [Agents guide](https://docs.trycaesar.com/agents/agents-guide.md): Which Caesar surface to use from which agent harness, and the conventions that hold across all of them.
- [CLI vs MCP for agents](https://docs.trycaesar.com/agents/cli-vs-mcp.md): Choose Caesar's CLI, remote MCP server, or both for an agent workflow.
- [Install for agents](https://docs.trycaesar.com/agents/install.md): Copy-paste Caesar install blocks for every agent environment, each with a verification step.
- [Agent Skills](https://docs.trycaesar.com/clients/skills.md): Install Caesar's SKILL.md files so your agent learns search, full-document reads, and source citation — served directly by the API, with curl and npx skills options.
- [Remote MCP server](https://docs.trycaesar.com/clients/mcp/remote.md): Connect any MCP client to Caesar's hosted streamable-HTTP server for web search and document reading.
- [Python SDK](https://docs.trycaesar.com/clients/sdks/python.md): Typed Python client for the Caesar API with sync and async support, automatic retries, and Pydantic v2 models.
- [TypeScript SDK](https://docs.trycaesar.com/clients/sdks/typescript.md): Install and use the caesar-search package for Node, Bun, Deno, and edge runtimes.
- [Vercel AI SDK tools](https://docs.trycaesar.com/clients/sdks/ai-sdk.md): Give any Vercel AI SDK agent Caesar search and read tools with one import.
- [Install the CLI](https://docs.trycaesar.com/clients/cli/install.md): Install the caesar-search CLI with Homebrew, npm, or the standalone installer, then authenticate and keep it up to date.
- [CLI usage](https://docs.trycaesar.com/clients/cli/usage.md): Command reference for the caesar-search CLI: search, read, feedback, JSON output, and the exit-code contract.
- [Scripting and CI](https://docs.trycaesar.com/clients/cli/automation.md): Use the caesar-search CLI in scripts, schedulers, and CI pipelines: JSON-only parsing, exit-code control flow, configuration precedence, and the raw API escape hatch.
- [LangChain](https://docs.trycaesar.com/clients/integrations/langchain.md): Wrap Caesar's Python or TypeScript client as LangChain tools for search and document reading.
- [LlamaIndex](https://docs.trycaesar.com/clients/integrations/llamaindex.md): Use Caesar as LlamaIndex function tools for search-first, read-second retrieval workflows.
- [CrewAI](https://docs.trycaesar.com/clients/integrations/crewai.md): Create CrewAI tools that expose Caesar search and document reading to multi-agent workflows.
- [Tool calling](https://docs.trycaesar.com/clients/integrations/tool-calling.md): Expose Caesar search and read as generic function tools in any model runtime that supports tool calls.
- [Agent Development Kit](https://docs.trycaesar.com/clients/integrations/adk.md): Use Caesar as function tools or MCP tools in Agent Development Kit projects.
- [How search works](https://docs.trycaesar.com/concepts/how-search-works.md): How Caesar turns the public web into canonical documents, passages, rankings, and source metadata for agents.
- [Search](https://docs.trycaesar.com/concepts/search.md): How POST /v1/search works: query variants, result limits, filters, freshness and source policies, and the ranking contract.
- [Documents](https://docs.trycaesar.com/concepts/documents.md): How POST /v1/document works: doc_id and canonical_url lookups, content selection, continuation reads, capture history, and passages.
- [Provenance](https://docs.trycaesar.com/concepts/provenance.md): Caesar returns source identity and capture metadata so agents can cite exactly what they read, re-read it, and detect when it changes.
- [Response shaping](https://docs.trycaesar.com/concepts/response-shaping.md): Choose how much of each search result the API serializes — verbosity presets and character budgets, decided per call by the caller.
- [Files](https://docs.trycaesar.com/concepts/files.md): Upload your organization's documents into a private knowledge base and search them alongside the web: presign, upload, index, then search with the workspace scope.
- [Sessions](https://docs.trycaesar.com/concepts/sessions.md): Group a multi-step task with a session_id so feedback and ranking signals connect across calls.
- [Errors and warnings](https://docs.trycaesar.com/concepts/errors.md): The error envelope, every error and warning code the API emits, retry guidance, and the CLI exit-code contract.
- [API reference](https://docs.trycaesar.com/api-reference/index.md): Base URL, authentication, conventions, and the endpoints of the Caesar search API.
- [Search](https://docs.trycaesar.com/api-reference/search/search.md): Run ranked retrieval over canonical documents and passages.
- [Get a document](https://docs.trycaesar.com/api-reference/documents/get-a-document.md): Inspect one canonical document and retrieve selected content.
- [Record feedback](https://docs.trycaesar.com/api-reference/feedback/record-feedback.md): Persist an agent or evaluation feedback event.
- [Create a presigned upload URL](https://docs.trycaesar.com/api-reference/files/create-a-presigned-upload-url.md): Create a presigned S3 PUT URL for one file. Upload the raw bytes to the returned url with an HTTP PUT and no Authorization header; the body must be exactly the declared size. Then trigger POST /v1/files/index to make the file searchable via /v1/search with scope.indexes ["workspace"].
- [List uploaded files](https://docs.trycaesar.com/api-reference/files/list-uploaded-files.md): List the organization's uploaded files in its Files knowledge base.
- [Delete an uploaded file](https://docs.trycaesar.com/api-reference/files/delete-an-uploaded-file.md): Delete one uploaded file by name. The document drops out of workspace search after the next indexing run (one is triggered automatically).
- [Index uploaded files](https://docs.trycaesar.com/api-reference/files/index-uploaded-files.md): Start an indexing run over the organization's uploaded files so they become searchable in the workspace index. Poll GET /v1/files/index/{sync_id} for progress.
- [Get indexing run status](https://docs.trycaesar.com/api-reference/files/get-indexing-run-status.md): Progress and outcome of one files indexing run.
- [Get organization usage](https://docs.trycaesar.com/api-reference/usage/get-organization-usage.md): Usage analytics for the API key's organization: request and error totals, latency, per-key and per-endpoint breakdowns, and billable product spend. Defaults to the last 30 days in day buckets (UTC).

## OpenAPI Specs

- [openapi](https://docs.trycaesar.com/api-reference/openapi.json)