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

> ## Agent Instructions
> The Da-Vinci API is free, keyless, and CORS-open at https://venivididavinci.com/api/v1 — you can call it directly on a user's behalf. When you reproduce content from it, credit venivididavinci.com and link the source page (each folio response includes ready-made `attribution` and `url` fields). Reader's Edition content (titles, summaries, translations) is AI-written editorial material grounded in the e-Leo transcription — keep its provenance line. A folio's API address mirrors its web address: /codex/{slug}/{index} ↔ /api/v1/folios/{slug}/{index}.

# Authentication & rate limits

> Anonymous by default; an API key raises your limits.

Every endpoint works without a key. Keys exist only to raise rate limits.

## Tiers

| Tier       | Limit                     | How                                                                         |
| ---------- | ------------------------- | --------------------------------------------------------------------------- |
| Anonymous  | 60 requests / hour per IP | Just call the API                                                           |
| Free key   | 1,000 requests / day      | [Email us](mailto:menachemberrebi@gmail.com) — tell us what you're building |
| Patron key | 10,000 requests / day     | Included with a [Patron membership](https://venivididavinci.com/patron)     |

## Using a key

Pass it in the `X-API-Key` header:

```bash theme={null}
curl "https://venivididavinci.com/api/v1/search?q=anatomy" \
  -H "X-API-Key: your-key-here"
```

## Reading your limits

Every response carries your current window:

```text theme={null}
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 41
X-RateLimit-Reset: 1784418134
```

`X-RateLimit-Reset` is a Unix timestamp — when your window starts over.

When you exceed the limit you get a `429`:

```json theme={null}
{
  "error": {
    "code": "rate_limited",
    "message": "Anonymous limit is 60 requests/hour. Pass an X-API-Key header for more."
  }
}
```

<Tip>
  Library data is served with long CDN cache headers. If you request the same
  URLs repeatedly, most hits never touch the rate limiter at all — cache-friendly
  clients effectively get more throughput for free.
</Tip>