Free tiers
| Tier | Price | Setup | Best for |
|---|---|---|---|
| Anonymous | Free | none | Evaluation, demos, local agents, quick scripts |
| API key | Free | partner access only | Higher throughput, attribution, repeat integrations |
Rate limits
| Tier | Included limit |
|---|---|
| Anonymous | 30 requests/second per client IP |
| API key | Per-key limit, default 100 requests/second |
X-RateLimit-* headers and an access.rate_limit block so agents can back off without guessing. Details: rate limits.
No credits to manage
There are no credits, request packs, overage meters, or billing settings. If Caesar introduces paid plans later, this page will be updated before billing is required. The current contract is simple: search, read, and feedback are free to use.Getting more capacity
Higher throughput currently requires an API key, and API keys are restricted to partners. If you have a partner key, keep it inCAESAR_API_KEY or use caesar-search auth login; never paste key material into a chat or docs page.
FAQ
Do I need a key?
Do I need a key?
No. Anonymous access works for search, read, and feedback. Use a key only when you have partner access and need higher throughput or account-scoped attribution.
What does a key change?
What does a key change?
A key gives requests a dedicated per-key rate-limit bucket. It does not change endpoint URLs, response fields, or the search-read-feedback contract.
Is feedback free?
Is feedback free?
Yes. Feedback uses the same free access model as search and read.
What happens if I hit a rate limit?
What happens if I hit a rate limit?
The API returns HTTP 429 with
X-RateLimit-* headers. Wait until X-RateLimit-Reset, reduce fan-out, or use a partner key if you have one.How should I request higher throughput?
How should I request higher throughput?
Partner API keys are currently restricted. If you already have one, use
CAESAR_API_KEY; otherwise keep using anonymous access until partner access is arranged.