Skip to content
InterlineaDocs
REST APITextDocs menu

Text

Any text, by URL, CTS URN or citation.

GET/api/v1/text

Resolves ref and returns the same shape as the section and passage endpoints. A work's URL or URN returns its opening section.

Parameters

Parameters
NameDescription
refstringRequiredA library or graded-passage URL, a CTS URN (urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46) or a citation ("Virgil, Aeneid 1.46").

Up to 500 characters. Example urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46.

includestringOptionalExtra fields, comma-separated: analysis (stored word-by-word analysis), context (stored notes).

Response

200 OK with a Text object.

Response fields
NameDescription
kindstringsection: a reading section of a library work. passage: a graded passage.

One of section, passage.

langstringLanguage code: la (Latin) or grc (Ancient Greek).

One of la, grc.

languagestring
titlestring"Aeneid 1.1-11" for a section; the passage title for a graded passage.
citationstring"Virgil, Aeneid 1.1-11": quote this when you cite the text.
refstring or nullThe section's first citation, as used in its URL. Null for a graded passage.
levelinteger or nullGraded passages: difficulty 1 to 5.
urnstring or nullCTS URN, e.g. urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11. Null when the edition has none (The Latin Library's own numbering).
urlstringCanonical page.
apistringAbsolute URL.
markdownstring or nullThe same text as Markdown.
authorobject
2 fields
author fields
namestring
urlstring or nullAbsolute URL.
workobject
3 fields
work fields
titlestring
urlstring or nullAbsolute URL.
urnstring or nullCTS URN, e.g. urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11. Null when the edition has none (The Latin Library's own numbering).
verseboolean
wordsinteger
textstringPlain text; verse keeps its line breaks.
prevLink or null
4 fields
prev fields
citationstring"Aeneid 1.12-33"
labelstring"Book 1, lines 12-33"
urlstringAbsolute URL.
apistringThe same resource as JSON.
nextLink or nullFollow next.api to read on without searching again.
4 fields
next fields
citationstring"Aeneid 1.12-33"
labelstring"Book 1, lines 12-33"
urlstringAbsolute URL.
apistringThe same resource as JSON.
creditCredit
5 fields
credit fields
textstringCredit line for the edition: author, work, editor, source, licence and changes. Quote it when you reuse the text.
licensestringCC BY-SA 4.0, CC BY 3.0, Used with permission (The Latin Library), or a public-domain note.
licenseUrlstring or null
sourcestringWhere the edition comes from.
qualitystringocr: an unproofread scan.

One of proofread, ocr.

analysisAnalysisOptionalOnly with include=analysis.
5 fields
analysis fields
analysedintegerSentences with a stored analysis.
totalintegerSentences in the text.
licensestringThe analyses adapt CC BY-SA text, so they are share-alike.

Always CC BY-SA 4.0.

notestring
sentencesarray of AnalysedSentence
4 fields
sentences fields
indexinteger0-based sentence index in the text.
textstring
translationstring or nullNull when the sentence has no stored analysis yet.
wordsarray of Word or nullNull when the sentence has no stored analysis yet.
11 fields
words fields
iinteger1-based index of the word in its sentence.
formstringThe word as printed.
lemmastringDictionary headword; Latin with macrons, Greek polytonic.
entrystring or nullDictionary entry: principal parts, or genitive and gender.
uposstringUniversal Dependencies part of speech.
featsstringUniversal Dependencies features, e.g. "Case=Acc|Gender=Neut|Number=Plur"; "_" if none.
headintegerIndex of the word this one depends on; 0 for the root.
deprelstringUniversal Dependencies relation to its head: nsubj, obj, amod, …
glossstringMeaning in this sentence, 1 to 4 words.
notestring or nullOne sentence on the word's role.
encliticobjectOptionalPresent only when an enclitic rides on the word, e.g. -que "and".
2 fields
enclitic fields
formstring
glossstring
contextContextOptionalOnly with include=context.
3 fields
context fields
machineWrittenbooleanFalse for the graded passages' hand-written notes.
sectionobject or nullNull until someone has opened Context for this part in the reader.
4 fields
section fields
soFarstring or nullWhat has happened in the work before this part.
herestring or nullWhat happens in this part, never a translation.
peoplearray of objectPeople, gods and places named here.
4 fields
people fields
namestring
notestring
formsarray of stringThe words in the text that name them.
wikipediastring or nullEnglish Wikipedia article title, when certain.
nextstring or nullWhat comes next.
workobject or nullA few lines about the work.
2 fields
work fields
introstring or null
notestring or null

Errors

StatusWhen
400 Bad RequestA parameter is missing or invalid, or the reference isn't a text.
404 Not FoundNot in the library.
429 Too Many RequestsToo many requests from one address. Wait a minute.
500 Internal Server ErrorSomething went wrong on our side.

Error bodies are described in Caching, limits and errors.

Example request

curl -G "https://interlinea.aeterna-institute.org/api/v1/text" \
  --data-urlencode "ref=urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46"

Example response

Response200 OK
{
  "kind": "section",
  "lang": "la",
  "language": "Latin",
  "title": "Aeneid 1.46-86",
  "citation": "Virgil, Aeneid 1.46-86",
  "ref": "1.46",
  "level": null,
  "urn": "urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46-1.86",
  "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.46",
  "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.46",
  "markdown": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.46.md",
  "author": {
    "name": "Virgil",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil"
  },
  "work": {
    "title": "Aeneid",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid",
    "urn": "urn:cts:latinLit:phi0690.phi003"
  },
  "verse": true,
  "words": 276,
  "text": "Ast ego, quae divom incedo regina, Iovisque\net soror et coniunx, una cum gente tot annos\nbella gero! Et quisquam numen Iunonis adoret\npraete…",
  "prev": {
    "citation": "Aeneid 1.1-45",
    "label": "Lines 1.1-1.45",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.1",
    "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.1"
  },
  "next": {
    "citation": "Aeneid 1.87-130",
    "label": "Lines 1.87-1.130",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.87",
    "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.87"
  },
  "credit": {
    "text": "Virgil, Aeneid, ed. J. B. Greenough. Text: the Perseus Digital Library, canonical-latinLit, CC BY-SA 4.0. Changes: apostrophes normalised an…",
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "source": "https://github.com/PerseusDL/canonical-latinLit/blob/master/data/phi0690/phi003/phi0690.phi003.perseus-lat2.xml",
    "quality": "proofread"
  }
}
Cache-Control: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800

Try it

Send a real GET from your browser and see the answer, its status and how long it took.

GET /api/v1/text?ref=urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46&include=analysis