{
"error": {
"code": "rate_limited",
"message": "Anonymous limit is 60 requests/hour. Get a free key at https://venivididavinci.com/developers and pass it as X-API-Key."
}
}
Search
One page, or a short list — never a guess
The strict door beside /search. A folio label (“CA 266v”, “Codex Arundel f. 12r”, “Ms F 12 recto”) names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.
GET
/
resolve
One page, or a short list — never a guess
curl --request GET \ --url https://venivididavinci.com/api/v1/resolve \ --header 'X-API-Key: <api-key>'
{
"error": {
"code": "rate_limited",
"message": "Anonymous limit is 60 requests/hour. Get a free key at https://venivididavinci.com/developers and pass it as X-API-Key."
}
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Da-Vinci API","description":"The complete notebooks of Leonardo da Vinci as structured data — scans, original Italian, and English translations for 7,549 manuscript pages.","colors":{"primary":"#9C4A2F","light":"#D97757","dark":"#7A3A25"},"logo":{"light":"https://mintcdn.com/veni-vidi-da-vinci/qUP4RJYhAY88PnzR/logo/light.svg?fit=max\u0026auto=format\u0026n=qUP4RJYhAY88PnzR\u0026q=85\u0026s=717c5c38492bbe73a91c36dfaa4d54fb","dark":"https://mintcdn.com/veni-vidi-da-vinci/qUP4RJYhAY88PnzR/logo/dark.svg?fit=max\u0026auto=format\u0026n=qUP4RJYhAY88PnzR\u0026q=85\u0026s=471ffb4919d636dc6ca6634f900026e3","href":"https://venivididavinci.com"},"favicon":"https://mintcdn.com/veni-vidi-da-vinci/qUP4RJYhAY88PnzR/favicon.svg?fit=max\u0026auto=format\u0026n=qUP4RJYhAY88PnzR\u0026q=85\u0026s=c8a12279187adacdd3414bbcec2a1047","background":{"color":{"dark":"#3B160D"}},"navbar":{"links":[{"href":"https://venivididavinci.com","label":"The Library"}],"primary":{"type":"button","label":"Become a Patron","href":"https://venivididavinci.com/patron"}},"footer":{"socials":{"x":"https://x.com/renaissanceml","website":"https://venivididavinci.com"}},"seo":{"metatags":{"canonical":"https://docs.venivididavinci.com"},"organization":{"id":"https://venivididavinci.com/#organization","name":"Veni Vidi Da Vinci","url":"https://venivididavinci.com","logo":"https://docs.venivididavinci.com/logo/light.svg","sameAs":["https://x.com/renaissanceml","https://venivididavinci.com"]}},"fonts":{"family":"Montserrat"},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"markdown":{"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}."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"veni-vidi-da-vinci","hasAudioNarration":false,"actualSubdomain":"veni-vidi-da-vinci","customDomains":["docs.venivididavinci.com"],"gitSource":{"type":"github","owner":"ok-revolution-6000","repo":"da-vinci","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad10ce57717b5a704b82ac0","collectionId":"1a10c9f8-a745-4c02-ba7c-fec23c1a6d9f","liveDeploymentHistoryId":"6ad10ce57717b5a704b82ac0","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad10ce57717b5a704b82ac0","clientVersion":"0.0.4039","searchFilterCounts":[{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Getting started","count":4},{"language":"default","tag":"Folios","count":3},{"language":"default","tag":"Tools","count":2},{"language":"default","tag":"Concepts","count":2},{"language":"default","tag":"Collections","count":2},{"language":"default","tag":"Search","count":2},{"language":"default","tag":"Subjects","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/search/one-page-or-a-short-list-—-never-a-guess","slug":"/api-reference/search/one-page-or-a-short-list-—-never-a-guess","pageMetadata":{"title":"One page, or a short list — never a guess","description":"The strict door beside `/search`. A folio label (\"CA 266v\", \"Codex Arundel f. 12r\", \"Ms F 12 recto\") names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The `da-vinci find` command is this endpoint.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /resolve","href":"/api-reference/search/one-page-or-a-short-list-—-never-a-guess","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"The strict door beside \", _jsx(_components.code, {\n children: \"/search\"\n }), \". A folio label (“CA 266v”, “Codex Arundel f. 12r”, “Ms F 12 recto”) names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The \", _jsx(_components.code, {\n children: \"da-vinci find\"\n }), \" command is this endpoint.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"One page, or a short list — never a guess","description":"The strict door beside `/search`. A folio label (\"CA 266v\", \"Codex Arundel f. 12r\", \"Ms F 12 recto\") names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The `da-vinci find` command is this endpoint.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /resolve","href":"/api-reference/search/one-page-or-a-short-list-—-never-a-guess","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"resolve","tags":["Search"],"summary":"One page, or a short list — never a guess","description":"The strict door beside `/search`. A folio label (\"CA 266v\", \"Codex Arundel f. 12r\", \"Ms F 12 recto\") names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The `da-vinci find` command is this endpoint.\n","parameters":["6cf9b2a1-7e68-4383-9183-840b240aafcb","7469ea5c-cbfe-4c18-97f2-20b7830456af","1019ce16-5203-440e-91db-71b15efa5db7"],"responses":{"200":"63141ad6-8e9f-49f5-b453-dac00cb04499","300":"c84e8ce2-d3f9-47c9-a822-a78f3220035a","400":"11d83493-032a-4eb9-8b7b-588cf0c68ea2","404":"81ad8fa9-2adb-4161-9b96-7d5ce840dc95","429":"25065812-54ae-4418-8f24-033d621b54b1"},"method":"get","type":"path","servers":["af123a3f-65a1-4532-a564-f7e392205af8"],"security":["c0d1193d-bcb8-4359-b3b9-b4a58fecd16d","b9832c41-4ca4-4ca7-a624-34799527ac1b"],"path":"/resolve","baseUrlOptions":["https://venivididavinci.com/api/v1"],"title":"One page, or a short list — never a guess","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6cf9b2a1-7e68-4383-9183-840b240aafcb":{"name":"q","in":"query","required":true,"description":"A phrase (`odometer and pedometer`) or a folio (`CA 266v`).","schema":{"type":"string","minLength":2,"isRequired":true,"description":"A phrase (`odometer and pedometer`) or a folio (`CA 266v`).","uniqueKey":"","typeLabel":"string"}},"7469ea5c-cbfe-4c18-97f2-20b7830456af":{"name":"subject","in":"query","required":false,"schema":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"1019ce16-5203-440e-91db-71b15efa5db7":{"name":"collection","in":"query","required":false,"description":"A slug or any name people use for it (`ca`, `arundel`, `ms f`).","schema":{"type":"string","isRequired":false,"description":"A slug or any name people use for it (`ca`, `arundel`, `ms f`).","uniqueKey":"","typeLabel":"string"}}},"responses":{"63141ad6-8e9f-49f5-b453-dac00cb04499":{"description":"One page.","content":{"application/json":{"schema":{"type":"object","required":["ok","query","how","folio"],"properties":{"ok":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"query":{"type":"string","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"how":{"type":"string","enum":["label","search"],"description":"What decided it — a folio label, or a search the page clearly led.","isRequired":true,"uniqueKey":"how","typeLabel":"enum\u003cstring>"},"folio":{"type":"object","description":"The complete record for one manuscript page.","required":["slug","index","folios","image","transcriptions","enrichment","url","attribution"],"properties":{"slug":{"type":"string","description":"One of the 28 enriched collections.","enum":["ambrosiana-drawings","codex-arundel","codex-atlanticus","codex-flight-of-birds","codex-forster-i","codex-forster-ii","codex-forster-iii","codex-madrid-i","codex-madrid-ii","codex-urbinas","paris-ashburnham-a","paris-ashburnham-b","paris-ms-a","paris-ms-b","paris-ms-c","paris-ms-d","paris-ms-e","paris-ms-f","paris-ms-g","paris-ms-h","paris-ms-i","paris-ms-k","paris-ms-l","paris-ms-m","turin-drawings","uffizi-drawings","usa-collection-drawings","venice-accademia-drawings"],"isRequired":true,"uniqueKey":"folio.slug","typeLabel":"enum\u003cstring>"},"index":{"type":"integer","isRequired":true,"uniqueKey":"folio.index","typeLabel":"integer"},"folios":{"type":"array","description":"Canonical folios this image carries in reading order, encoded `\u003cnumber>|\u003cside>`, e.g. `[\"3|r\"]`; an Arundel opening carries two.","items":{"type":"string","uniqueKey":"folio.folios.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"folio.folios","typeLabel":"string[]"},"image":{"type":"object","description":"Public scan URLs in three sizes, served from the CDN.","required":["thumbnail","medium","highRes"],"properties":{"thumbnail":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"folio.image.thumbnail","typeLabel":"string\u003curi>"},"medium":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"folio.image.medium","typeLabel":"string\u003curi>"},"highRes":{"type":"string","format":"uri","example":"https://codex.venivididavinci.com/codices/codex-arundel/highres/001_ff.-14v-1r.jpg","isRequired":true,"uniqueKey":"folio.image.highRes","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"folio.image","typeLabel":"object"},"transcriptions":{"type":"array","description":"Original e-Leo transcriptions on this image (empty when none survives).","items":{"type":"object","description":"One folio's original e-Leo transcription. A page image can carry more than one (an opening shows two folios).","required":["folio","hasText","texts"],"properties":{"folio":{"type":"string","description":"Which folio this transcription belongs to, e.g. `3r`.","isRequired":true,"uniqueKey":"folio.transcriptions.items.[INDEX].folio","typeLabel":"string"},"hasText":{"type":"boolean","isRequired":true,"uniqueKey":"folio.transcriptions.items.[INDEX].hasText","typeLabel":"boolean"},"texts":{"type":"array","items":{"type":"object","required":["title","text"],"properties":{"title":{"type":"string","description":"e-Leo block heading (often empty).","isRequired":true,"uniqueKey":"folio.transcriptions.items.[INDEX].texts.items.[INDEX].title","typeLabel":"string"},"text":{"type":"string","description":"Leonardo's original Italian, as transcribed by e-Leo.","isRequired":true,"uniqueKey":"folio.transcriptions.items.[INDEX].texts.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"folio.transcriptions.items.[INDEX].texts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"folio.transcriptions.items.[INDEX].texts","typeLabel":"object[]"}},"uniqueKey":"folio.transcriptions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"folio.transcriptions","typeLabel":"object[]"},"enrichment":{"oneOf":[{"type":"object","description":"Reader's Edition record; null for the few pages outside enrichment scope.","required":["title","subjects","summary","kind","source","items","english"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.title","typeLabel":"string"},"subjects":{"type":"array","maxItems":4,"items":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"uniqueKey":"folio.enrichment.oneOf.0.subjects.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.subjects","typeLabel":"enum\u003cstring>[]"},"summary":{"type":"string","description":"Plain-English overview of the whole page.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.summary","typeLabel":"string"},"kind":{"type":"string","enum":["leaf","variant","flyleaf","binding"],"description":"`leaf` for a content page; `flyleaf`/`binding` for non-content pages; `variant` for a spectral re-shoot.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["transcribed","caption-only","none"],"description":"What grounded the record — a full e-Leo transcription, only a catalogue caption, or the scan alone.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.source","typeLabel":"enum\u003cstring>"},"items":{"type":"array","items":{"type":"object","description":"One grounded highlight — a specific thing on the page, with an evidence pointer back to the source.","required":["subject","heading","excerpt","evidence"],"properties":{"subject":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX].subject","typeLabel":"enum\u003cstring>"},"heading":{"type":"string","example":"The balance a b c and the seat of equality","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX].heading","typeLabel":"string"},"excerpt":{"type":"string","description":"Plain-English account of this element, grounded in the transcription or the visible drawing.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX].excerpt","typeLabel":"string"},"evidence":{"type":"string","description":"`text:\u003cn>` points at source block n of the transcription; `visual:\u003cdescription>` grounds in the drawing itself.","example":"text:2","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX].evidence","typeLabel":"string"},"region":{"type":"string","description":"Where on the sheet this element sits.","example":"balance diagrams, upper right","uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX].region","typeLabel":"string"}},"uniqueKey":"folio.enrichment.oneOf.0.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.\\items","typeLabel":"object[]"},"english":{"type":"array","description":"Complete English translation, one entry per source transcription block.","items":{"type":"object","description":"English translation of one source transcription block, aligned 1:1 by order.","required":["order","textEN"],"properties":{"order":{"type":"integer","description":"Position of the source block this translates (1-based).","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.english.items.[INDEX].order","typeLabel":"integer"},"textEN":{"type":"string","description":"The English translation.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.english.items.[INDEX].textEN","typeLabel":"string"},"titleEN":{"type":"string","description":"Translated block heading (often empty).","uniqueKey":"folio.enrichment.oneOf.0.english.items.[INDEX].titleEN","typeLabel":"string"}},"uniqueKey":"folio.enrichment.oneOf.0.english.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0.english","typeLabel":"object[]"},"subtitle":{"type":"string","uniqueKey":"folio.enrichment.oneOf.0.subtitle","typeLabel":"string"}},"isRequired":true,"uniqueKey":"folio.enrichment.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reader's Edition record; null for the few pages outside enrichment scope.","isRequired":true,"uniqueKey":"folio.enrichment.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"folio.enrichment","typeLabel":"object | null"},"url":{"type":"string","format":"uri","description":"The page on venivididavinci.com — link here when you reproduce content.","isRequired":true,"uniqueKey":"folio.url","typeLabel":"string\u003curi>"},"attribution":{"type":"string","description":"Ready-made credit line.","example":"Reader's Edition — venivididavinci.com/codex/codex-flight-of-birds/6","isRequired":true,"uniqueKey":"folio.attribution","typeLabel":"string"},"label":{"type":"string","example":"f. 3r","uniqueKey":"folio.label","typeLabel":"string"},"kind":{"type":"string","enum":["leaf","variant"],"description":"`variant` marks a spectral re-shoot (UV / transmitted light) of a sheet already in the set.","uniqueKey":"folio.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"folio","typeLabel":"object"},"matched":{"type":"array","items":{"type":"string","uniqueKey":"matched.items.[INDEX]","typeLabel":"string"},"uniqueKey":"matched","typeLabel":"string[]"},"matchedItem":{"oneOf":[{"type":"object","description":"The passage of the page in which every query term co-occurred, when one did.","properties":{"subject":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"uniqueKey":"matchedItem.oneOf.0.subject","typeLabel":"enum\u003cstring>"},"heading":{"type":"string","uniqueKey":"matchedItem.oneOf.0.heading","typeLabel":"string"}},"uniqueKey":"matchedItem.oneOf.0","typeLabel":"object"},{"type":"null","description":"The passage of the page in which every query term co-occurred, when one did.","properties":{"subject":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"]},"heading":{"type":"string"}},"uniqueKey":"matchedItem.oneOf.1","typeLabel":"null"}],"uniqueKey":"matchedItem","typeLabel":"object | null"},"score":{"type":"number","uniqueKey":"score","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"query":"\u003cstring>","how":"label","folio":{"slug":"ambrosiana-drawings","index":123,"folios":["\u003cstring>"],"image":{"thumbnail":"\u003cstring>","medium":"\u003cstring>","highRes":"https://codex.venivididavinci.com/codices/codex-arundel/highres/001_ff.-14v-1r.jpg"},"transcriptions":[{"folio":"\u003cstring>","hasText":true,"texts":[{"title":"\u003cstring>","text":"\u003cstring>"}]}],"enrichment":{"title":"\u003cstring>","subjects":["geometry"],"summary":"\u003cstring>","kind":"leaf","source":"transcribed","items":[{"subject":"geometry","heading":"The balance a b c and the seat of equality","excerpt":"\u003cstring>","evidence":"text:2","region":"balance diagrams, upper right"}],"english":[{"order":123,"textEN":"\u003cstring>","titleEN":"\u003cstring>"}],"subtitle":"\u003cstring>"},"url":"\u003cstring>","attribution":"Reader's Edition — venivididavinci.com/codex/codex-flight-of-birds/6","label":"f. 3r","kind":"leaf"},"matched":["\u003cstring>"],"matchedItem":{"subject":"geometry","heading":"\u003cstring>"},"score":123}}},"exampleType":"generated"}},"exampleType":"generated"},"c84e8ce2-d3f9-47c9-a822-a78f3220035a":{"description":"Several pages fit about equally; choose one. Not an error.","content":{"application/json":{"schema":{"type":"object","required":["ok","error","query","candidates"],"properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","bad_request","rate_limited","ambiguous"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"query":{"type":"string","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"candidates":{"type":"array","items":{"type":"object","description":"Lightweight page reference — enough to render an index or card.","required":["matchedIn","snippet","slug","index","title","subjects","url"],"properties":{"slug":{"type":"string","description":"One of the 28 enriched collections.","enum":["ambrosiana-drawings","codex-arundel","codex-atlanticus","codex-flight-of-birds","codex-forster-i","codex-forster-ii","codex-forster-iii","codex-madrid-i","codex-madrid-ii","codex-urbinas","paris-ashburnham-a","paris-ashburnham-b","paris-ms-a","paris-ms-b","paris-ms-c","paris-ms-d","paris-ms-e","paris-ms-f","paris-ms-g","paris-ms-h","paris-ms-i","paris-ms-k","paris-ms-l","paris-ms-m","turin-drawings","uffizi-drawings","usa-collection-drawings","venice-accademia-drawings"],"isRequired":true,"uniqueKey":"candidates.items.[INDEX].slug","typeLabel":"enum\u003cstring>"},"index":{"type":"integer","description":"Zero-based image index within the collection.","isRequired":true,"uniqueKey":"candidates.items.[INDEX].index","typeLabel":"integer"},"title":{"type":"string","description":"Reader's Edition title.","example":"Mechanical Science, Balances, and the Centre of Gravity","isRequired":true,"uniqueKey":"candidates.items.[INDEX].title","typeLabel":"string"},"subjects":{"type":"array","items":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"uniqueKey":"candidates.items.[INDEX].subjects.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"candidates.items.[INDEX].subjects","typeLabel":"enum\u003cstring>[]"},"url":{"type":"string","format":"uri","description":"The page on venivididavinci.com.","isRequired":true,"uniqueKey":"candidates.items.[INDEX].url","typeLabel":"string\u003curi>"},"matchedIn":{"type":"string","enum":["title","subtitle","headings","keywords","subjects","excerpts","english","italian","summary","collection","label"],"description":"The highest-weighted field the query matched.","isRequired":true,"uniqueKey":"candidates.items.[INDEX].matchedIn","typeLabel":"enum\u003cstring>"},"snippet":{"type":"string","description":"The matching passage — the item every term fell in, else the summary.","isRequired":true,"uniqueKey":"candidates.items.[INDEX].snippet","typeLabel":"string"},"label":{"type":"string","description":"Folio label as printed in the manuscript, e.g. `f. 3r`.","uniqueKey":"candidates.items.[INDEX].label","typeLabel":"string"},"kind":{"type":"string","enum":["leaf","variant","flyleaf","binding"],"description":"`leaf` is a regular page; `variant` a spectral re-shoot; `flyleaf`/`binding` are non-content pages.","uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"thumbnail":{"type":"string","format":"uri","description":"Small scan image (CDN).","uniqueKey":"candidates.items.[INDEX].thumbnail","typeLabel":"string\u003curi>"},"matched":{"type":"array","items":{"type":"string","uniqueKey":"candidates.items.[INDEX].matched.items.[INDEX]","typeLabel":"string"},"description":"The terms (after alias expansion) that matched, one per query word.","uniqueKey":"candidates.items.[INDEX].matched","typeLabel":"string[]"},"matchedItem":{"oneOf":[{"type":"object","description":"The passage of the page in which every query term co-occurred, when one did.","properties":{"subject":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"],"uniqueKey":"candidates.items.[INDEX].matchedItem.oneOf.0.subject","typeLabel":"enum\u003cstring>"},"heading":{"type":"string","uniqueKey":"candidates.items.[INDEX].matchedItem.oneOf.0.heading","typeLabel":"string"}},"uniqueKey":"candidates.items.[INDEX].matchedItem.oneOf.0","typeLabel":"object"},{"type":"null","description":"The passage of the page in which every query term co-occurred, when one did.","properties":{"subject":{"type":"string","description":"One of the 25 frozen subject terms.","enum":["geometry","arithmetic-and-proportion","physics-and-mechanics","hydraulics","anatomy","geology","astronomy","optics-and-light","botany","flight","machines-and-devices","weapons-and-fortification","architecture","civil-engineering","painting-and-perspective","figure-studies","sculpture-and-casting","horses-and-animals","landscape","cartography","ornament-and-heraldry","lists-and-accounts","language-and-latin","personal-notes","fables-and-prose"]},"heading":{"type":"string"}},"uniqueKey":"candidates.items.[INDEX].matchedItem.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].matchedItem","typeLabel":"object | null"},"score":{"type":"number","description":"The relevance score; comparable within one response only.","uniqueKey":"candidates.items.[INDEX].score","typeLabel":"number"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"not_found","message":"\u003cstring>","hint":"\u003cstring>"},"query":"\u003cstring>","candidates":[{"slug":"ambrosiana-drawings","index":123,"title":"Mechanical Science, Balances, and the Centre of Gravity","subjects":["geometry"],"url":"\u003cstring>","matchedIn":"title","snippet":"\u003cstring>","label":"\u003cstring>","kind":"leaf","thumbnail":"\u003cstring>","matched":["\u003cstring>"],"matchedItem":{"subject":"geometry","heading":"\u003cstring>"},"score":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"11d83493-032a-4eb9-8b7b-588cf0c68ea2":{"description":"Invalid or missing parameter.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","bad_request","rate_limited","ambiguous"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"bad_request","message":"Parameter 'q' is required and must be at least 2 characters."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"Parameter 'q' is required and must be at least 2 characters."}}}},"exampleType":"examples"}},"exampleType":"examples"},"81ad8fa9-2adb-4161-9b96-7d5ce840dc95":{"description":"No page fits.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","bad_request","rate_limited","ambiguous"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"25065812-54ae-4418-8f24-033d621b54b1":{"description":"Rate limit exceeded — check `X-RateLimit-Reset`, or pass an API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","bad_request","rate_limited","ambiguous"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited","message":"Anonymous limit is 60 requests/hour. Get a free key at https://venivididavinci.com/developers and pass it as X-API-Key."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"Anonymous limit is 60 requests/hour. Get a free key at https://venivididavinci.com/developers and pass it as X-API-Key."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c0d1193d-bcb8-4359-b3b9-b4a58fecd16d":{},"b9832c41-4ca4-4ca7-a624-34799527ac1b":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Optional — raises your rate limit. Patron keys get the highest tier.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"af123a3f-65a1-4532-a564-f7e392205af8":{"url":"https://venivididavinci.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Optional — raises your rate limit. Patron keys get the highest tier.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Optional — raises your rate limit. Patron keys get the highest tier.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"veni-vidi-da-vinci","siteName":"Da-Vinci API","title":"One page, or a short list — never a guess - Da-Vinci API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T17:27:05.660Z","originalFileLocation":"api-reference/search/one-page-or-a-short-list-—-never-a-guess.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The strict door beside /search. A folio label (\u0026quot;CA 266v\u0026quot;, \u0026quot;Codex Arundel f. 12r\u0026quot;, \u0026quot;Ms F 12 recto\u0026quot;) names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Da-Vinci API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"One page, or a short list — never a guess - Da-Vinci API\">\u003cmeta data-mint-head property=\"og:description\" content=\"The strict door beside /search. A folio label (\u0026quot;CA 266v\u0026quot;, \u0026quot;Codex Arundel f. 12r\u0026quot;, \u0026quot;Ms F 12 recto\u0026quot;) names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Da-Vinci API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-—-never-a-guess\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://veni-vidi-da-vinci.mintlify.app/_mintlify/api/og/v2?division=Search\u0026amp;title=One+page%2C+or+a+short+list+%E2%80%94+never+a+guess\u0026amp;description=The+strict+door+beside+%60%2Fsearch%60.+A+folio+label+%28%22CA+266v%22%2C+%22Codex+Arundel+f.+12r%22%2C+%22Ms+F+12+recto%22%29+names+one+page+outright.+A+phrase+is+searched%2C+and+the+best\u0026amp;theme=9fbfc6facb378b11feba33b1\u0026amp;signature=4a76a3aab88a4021be4d3120e4cc8d0fe16d84da042e4e65414117c7db9ad59a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"One page, or a short list — never a guess - Da-Vinci API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The strict door beside /search. A folio label (\u0026quot;CA 266v\u0026quot;, \u0026quot;Codex Arundel f. 12r\u0026quot;, \u0026quot;Ms F 12 recto\u0026quot;) names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veni-vidi-da-vinci.mintlify.app/_mintlify/api/og/v2?division=Search\u0026amp;title=One+page%2C+or+a+short+list+%E2%80%94+never+a+guess\u0026amp;description=The+strict+door+beside+%60%2Fsearch%60.+A+folio+label+%28%22CA+266v%22%2C+%22Codex+Arundel+f.+12r%22%2C+%22Ms+F+12+recto%22%29+names+one+page+outright.+A+phrase+is+searched%2C+and+the+best\u0026amp;theme=9fbfc6facb378b11feba33b1\u0026amp;signature=4a76a3aab88a4021be4d3120e4cc8d0fe16d84da042e4e65414117c7db9ad59a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/veni-vidi-da-vinci/DKdySFN2CCIRqy5i/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Da-Vinci API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9C4A2F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-—-never-a-guess\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://venivididavinci.com/#organization\",\"name\":\"Veni Vidi Da Vinci\",\"url\":\"https://venivididavinci.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.venivididavinci.com/logo/light.svg\"},\"sameAs\":[\"https://x.com/renaissanceml\",\"https://venivididavinci.com\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.venivididavinci.com#website\",\"name\":\"Da-Vinci API\",\"url\":\"https://docs.venivididavinci.com\",\"publisher\":{\"@id\":\"https://venivididavinci.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess#webpage\",\"url\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess\",\"name\":\"One page, or a short list — never a guess\",\"description\":\"The strict door beside /search. A folio label (\\\"CA 266v\\\", \\\"Codex Arundel f. 12r\\\", \\\"Ms F 12 recto\\\") names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.\",\"dateModified\":\"2026-10-15T17:27:05.660Z\",\"isPartOf\":{\"@id\":\"https://docs.venivididavinci.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Search\",\"item\":\"https://docs.venivididavinci.com/api-reference/search/search-the-pages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"One page, or a short list — never a guess\",\"item\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess#apireference\",\"headline\":\"One page, or a short list — never a guess\",\"name\":\"One page, or a short list — never a guess\",\"description\":\"The strict door beside /search. A folio label (\\\"CA 266v\\\", \\\"Codex Arundel f. 12r\\\", \\\"Ms F 12 recto\\\") names one page outright. A phrase is searched, and the best page is the answer only when it clearly leads: its score well ahead of the runner-up and every term found in one passage or in the title. Anything closer is a list. The da-vinci find command is this endpoint.\",\"url\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venivididavinci.com/api-reference/search/one-page-or-a-short-list-%E2%80%94-never-a-guess#webpage\"},\"dateModified\":\"2026-10-15T17:27:05.660Z\",\"publisher\":{\"@id\":\"https://venivididavinci.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.venivididavinci.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Da-Vinci API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Da-Vinci API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Collections","pages":[{"title":"List all collections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /collections","href":"/api-reference/collections/list-all-collections"},{"title":"Get a collection with its pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /collections/{slug}","href":"/api-reference/collections/get-a-collection-with-its-pages"}]},{"group":"Folios","pages":[{"title":"Get one page in full","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /folios/{slug}/{index}","href":"/api-reference/folios/get-one-page-in-full"},{"title":"One page by the folio number written on it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /folios/{slug}/f/{label}","href":"/api-reference/folios/one-page-by-the-folio-number-written-on-it"},{"title":"Get a random page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /random","href":"/api-reference/folios/get-a-random-page"}]},{"group":"Subjects","pages":[{"title":"List the subject vocabulary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /subjects","href":"/api-reference/subjects/list-the-subject-vocabulary"},{"title":"Get pages tagged with a subject","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /subjects/{id}","href":"/api-reference/subjects/get-pages-tagged-with-a-subject"}]},{"group":"Search","pages":[{"title":"Search the pages","description":"Every query term must occur somewhere in the page — its title, subtitle, summary, the headings and excerpts of its passages, the English translation or the Italian transcription. A hand-curated alias file lets English reach the Italian and the subject ids reach plain words (\"birds\" finds \"uccelli\"). Ranking is BM25F with the title weighted most, and a page where every term falls in one passage ranks highest; each hit says which passage matched. Filter by subject and/or collection (a slug or any of its names). For one exact page use `/resolve`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /search","href":"/api-reference/search/search-the-pages"},{"title":"One page, or a short list — never a guess","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /resolve","href":"/api-reference/search/one-page-or-a-short-list-—-never-a-guess"}]}]}]},"basePath":"","title":"One page, or a short list — never a guess - Da-Vinci API","buildId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","deploymentId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CVpqyvFO.js","utils-vpweLD0v.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BIOodqb0.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1LM3qmu.js","snippetPresets-C5xK0GtN.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CCsxLnQl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C2-WKG22.js","shallow-SdoLUC-q.js","getApiPlaygroundDisplay-BnI8L2hB.js","CodeSnippet-D5M8NCHI.js","CodeSnippets-CXRO8Uom.js","Page-CN9QbZiA.js","getPastedJson-CrfHEdRt.js","icon-Cr8AyUnW.js","MethodPill-J_Cs0kNw.js","DuplicateIcon-DrMboxGw.js","createIcon-B4CIWVbU.js","DynamicMarkdown-D9cdbgj9.js","SectionHeading-BO4CouT0.js","axios-vUo_bRtp.js","Markdown-L1m1-PSi.js","clsx-rIpTdK8h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-ptfS1uB_.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D31Sm3f9.js"]}