> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycaesar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> Caesar search uses account credits for API usage, with a limited-time $1,000 starting credit grant for new accounts.

Caesar API usage is credit-backed. [Sign up in the Caesar app](https://app.trycaesar.com), create an API key, and add credits when you need more capacity. For a limited time, all accounts receive a \$1,000 starting credit grant.

```bash theme={"system"}
curl -s https://alpha.api.trycaesar.com/v1/search \
  -H "Authorization: Bearer $CAESAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "postgres 17 logical replication failover", "max_results": 3}'
```

## Getting started

| Step           | Action                                                                                   |
| -------------- | ---------------------------------------------------------------------------------------- |
| Create account | [Open the Caesar app](https://app.trycaesar.com) and sign up.                            |
| Get a key      | Create an API key and store it in `CAESAR_API_KEY` or your secret manager.               |
| Start building | Use the \$1,000 limited-time starting credit grant for search, read, and feedback calls. |
| Add capacity   | Top up credits in the app when your balance runs low.                                    |

All API calls use the same public endpoints and response shapes. A key identifies the account that owns usage, rate limits, document grants, and feedback attribution. See [authentication](/authentication).

## Rate limits

| Credential |                             Included limit |
| ---------- | -----------------------------------------: |
| API key    | Per-key limit, default 100 requests/second |

Every response includes `X-RateLimit-*` headers and an `access.rate_limit` block so agents can back off without guessing. Details: [rate limits](/rate-limits).

## Credits

Credits fund API usage across search, read, and feedback. The app shows balance, usage, payment methods, and top-ups for the account or team that owns the key.

<Info>
  For a limited time, all accounts receive a \$1,000 starting credit grant. The grant is meant to cover evaluation and early integration work before you add paid credits.
</Info>

## Getting more capacity

Create additional API keys, manage credits, and add payment methods in the [Caesar app](https://app.trycaesar.com). Keep keys in `CAESAR_API_KEY`, the CLI key store, or your secret manager; never paste key material into a chat or docs page.

## FAQ

<AccordionGroup>
  <Accordion title="Do I need a key?">
    Yes. Search, read, and feedback calls require an API key. Create one in the [Caesar app](https://app.trycaesar.com).
  </Accordion>

  <Accordion title="What does a key change?">
    A key attaches requests to your account for credits, rate limits, document grants, and feedback attribution. It does not change endpoint URLs, response fields, or the search-read-feedback contract.
  </Accordion>

  <Accordion title="What does the starting grant cover?">
    For a limited time, all accounts get a \$1,000 credit grant for API usage while they evaluate and build their first integration.
  </Accordion>

  <Accordion title="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 contact Caesar if your integration needs a higher per-key limit.
  </Accordion>

  <Accordion title="How do I get higher throughput?">
    Use the app to manage keys and billing, then contact Caesar if you need a custom per-key limit.
  </Accordion>
</AccordionGroup>