# Da-Vinci API

> The complete notebooks of Leonardo da Vinci as structured data — scans, original Italian, and English translations for 7,549 manuscript pages.

> ## 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}.

## Docs

- [Get a collection with its pages](https://docs.venivididavinci.com/api-reference/collections/get-a-collection-with-its-pages.md): One collection plus a paginated list of its folios in reading order. Each folio summary carries enough to render an index or pick pages to fetch in full.
- [List all collections](https://docs.venivididavinci.com/api-reference/collections/list-all-collections.md): Every collection in the library with its institution, location, page count, and how many of its pages carry a Reader's Edition record.
- [Get a random page](https://docs.venivididavinci.com/api-reference/folios/get-a-random-page.md): One random enriched page, optionally constrained to a subject and/or a collection. Returns the same full record as `GET /folios/{slug}/{index}`. Ideal for "page of the day" features.
- [Get one page in full](https://docs.venivididavinci.com/api-reference/folios/get-one-page-in-full.md): The complete record for one manuscript page: scan URLs in three sizes, the original e-Leo transcription (Italian) when one exists, and the full Reader's Edition layer — title, subtitle, subjects, summary, grounded highlights, and the English translation aligned block-by-block with the source.
- [Search the Reader's Edition layer](https://docs.venivididavinci.com/api-reference/search/search-the-readers-edition-layer.md): Case-insensitive full-text search over titles, subtitles, summaries, highlight excerpts, and the English translations. Filter by subject and/or collection. Results are ranked by where the match occurs (title > subtitle > summary > highlights > translation).
- [Get pages tagged with a subject](https://docs.venivididavinci.com/api-reference/subjects/get-pages-tagged-with-a-subject.md): One subject term plus a paginated list of every page tagged with it, across all collections.
- [List the subject vocabulary](https://docs.venivididavinci.com/api-reference/subjects/list-the-subject-vocabulary.md): The frozen 25-term vocabulary every page is tagged with, grouped into five scholarly buckets, with a scope note and the number of tagged pages for each term.
- [Attribution & licensing](https://docs.venivididavinci.com/attribution.md): The API is free to build on. Here is the one thing we ask.
- [Authentication & rate limits](https://docs.venivididavinci.com/authentication.md): Anonymous by default; an API key raises your limits.
- [The data model](https://docs.venivididavinci.com/data-model.md): Collections, folios, and how the Reader's Edition layer is grounded.
- [Da-Vinci API](https://docs.venivididavinci.com/index.md): The complete notebooks of Leonardo da Vinci as structured data.
- [Quickstart](https://docs.venivididavinci.com/quickstart.md): Your first request in under a minute — no key required.
- [The subject vocabulary](https://docs.venivididavinci.com/subjects.md): The frozen 25-term taxonomy every page is tagged with.

## OpenAPI Specs

- [openapi](https://docs.venivididavinci.com/api-reference/openapi.yaml)