Developer Platform

The Da-Vinci API

The complete notebooks of Leonardo da Vinci, as structured data. High-resolution scans, the original Italian transcriptions, and a full English translation of every page — free, read-only, and keyless. Build with it.

  • 28Collections
  • 7,549Pages
  • 25Subjects
  • 7Endpoints

One request, one page

No signup, no SDK. A folio's API address mirrors its address on the site — /codex/{slug}/{index} becomes /api/v1/folios/{slug}/{index}.

$ curl https://venivididavinci.com/api/v1/random

{
  "slug": "codex-flight-of-birds",
  "index": 6,
  "image": { "highRes": "https://codex.venivididavinci.com/…" },
  "enrichment": {
    "title": "Mechanical Science, Balances, and the Centre of Gravity",
    "subjects": ["physics-and-mechanics", "machines-and-devices"],
    "summary": "The page opens with Leonardo's declaration that…",
    "english": [{ "order": 1, "textEN": "Instrumental or mechanical science…" }]
  },
  "url": "https://venivididavinci.com/codex/codex-flight-of-birds/6",
  "attribution": "Reader's Edition — venivididavinci.com/codex/codex-flight-of-birds/6"
}

Or skip the HTTP entirely

The whole library ships as a command-line tool — zero dependencies, open source, and the --json flag pipes straight into scripts and agents.

$ npx leonardo-davinci random --subject anatomy
$ npm i -g leonardo-davinci        # installs the da-vinci command
$ da-vinci search "flying machine"
$ da-vinci folio codex-atlanticus 1646 --full
$ da-vinci download codex-arundel 30 --size highRes

Endpoints

Seven read-only endpoints under https://venivididavinci.com/api/v1. Full schemas, parameters, and interactive try-it panels live in the reference.

  • GET/v1/collectionsEvery collection, with page and enrichment counts
  • GET/v1/collections/{slug}One collection and a paginated list of its pages
  • GET/v1/folios/{slug}/{index}One page in full — scan, Italian, and translation
  • GET/v1/subjectsThe frozen 25-term subject vocabulary
  • GET/v1/subjects/{id}Every page tagged with a subject, across all collections
  • GET/v1/searchFull-text search over the Reader's Edition layer
  • GET/v1/randomA random page — the 'page of the day' endpoint

Three layers on every page

The scan

Public high-resolution photography in three sizes, served from a CDN. Thumbnail, medium, and full-quality.

The original

The scholarly e-Leo transcription of Leonardo's Italian, in ordered text blocks — where one survives.

The Reader's Edition

An editorial title, subject tags, a plain-English summary, evidence-linked highlights, and a complete English translation aligned to the source.

Free, with attribution

Anonymous requests work out of the box (60/hour). A free key lifts that to 1,000/day; a Patron key to 10,000/day. Anything you build must credit venivididavinci.com and link the source page — every response ships a ready-made attribution string.