Skip to content
InterlineaDocs
Get startedOverviewDocs menu

Developer docs

Read the Interlinea library from an AI assistant, your own code or a script: Latin and Greek texts with citations, stored word analyses and context notes. Free, read only, no key.

GET/api/v1/text?ref=Virgil, Aeneid 1.1Try it

Arma virumque cano, Troiae qui primus ab orisItaliam, fato profugus, Laviniaque venitlitora, multum ille et terris iactatus et altovi superum saevae memorem Iunonis ob iram;multa quoque et bello passus, dum conderet urbem,

Virgil, Aeneid 1.1-45urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.45
{
  "citation": "Virgil, Aeneid 1.1-45",
  "words": 287,
  "verse": true,
  "credit": {
    "license": "CC BY-SA 4.0"
  },
  "next": {
    "citation": "Aeneid 1.46-86"
  }
}

What you can do

  • Read any text in the library, a section at a time, with its citation, canonical URL, CTS URN where the edition has one, and the edition's credit and licence. Each section links to the next, so you can read a whole work in order.
  • Get the stored word-by-word analysis: each word's dictionary form, grammar, role in the sentence and meaning in context, with a translation of each sentence.
  • Get the context notes: what has happened so far, who and where is named, and what comes next.
  • Follow the graded path: short Latin and Greek passages for learners, levels 1 to 5, each analysed in full.
  • Search authors, works and topics, and look a word up across every stored analysis.

What it costs

Nothing. Every endpoint is free and read only, with no key, no account and no cookies. Please keep to about 120 requests a minute from one address. Past that you get 429 Too Many Requests for the rest of the minute. If you need more, write to us.

Nothing here calls a language model. You get what is stored: every graded passage is analysed in full, and a library section once a reader has opened it in Interlinea. Analyses and context explains when each exists.

Reading these pages

Code here takes the reader's case colours, and a colour marks a role, as a case does in a sentence. HTTP methods and tool calls are verbs, so they are rubric red.

  • Nominativenames: keys and fields"citation"
  • Accusativestrings"Arma virumque cano"
  • Dativenumbers46
  • Genitivekeywordsawait
  • Ablativetrue, false and nullnull
  • Vocativeflags--transport
  • Verbcommands, function calls and HTTP methodsGET

Next steps