REST API · Texts

Words

Look a word up in the stored analyses.

GET/api/v1/words

A headword's spellings and meanings in context, and cited sentences where it occurs. Accents, breathings and macrons are ignored: fio finds fīō.

Parameters

Parameters
Name	Description
`lemma`string	RequiredDictionary form: amo, arma, λόγος. Up to 60 characters. Example `arma`.
`lang`string	OptionalDefaults to Greek for Greek letters, otherwise Latin. One of `la`, `grc`, `latin`, `greek`.
`limit`integer	OptionalOccurrences, at most 50. Default `10`. From 1 to 50.

Response

200 OK with a WordLookup object.

Name Description

lemmastring The headword asked for.

langstring

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

One of la, grc.

entriesarray of object

Each headword spelling found, with the meanings it had in context.

5 fields

entries fields
`lemma`string
`entry`string or null
`upos`string
`glosses`array of string
`count`integer

occurrencesarray of object

11 fields

occurrences fields
`form`string
`lemma`string
`upos`string
`feats`string
`gloss`string
`sentence`string
`translation`string
`citation`string
`url`string	Absolute URL.
`api`string	Absolute URL.
`license`string

creditsarray of string Credit lines for the editions quoted above.

notestring

Errors

Status	When
`400 Bad Request`	A parameter is missing or invalid, or the reference isn't a text.
`429 Too Many Requests`	Too many requests from one address. Wait a minute.
`500 Internal Server Error`	Something went wrong on our side.

Error bodies are described in Caching, limits and errors.

Example request

curl "https://interlinea.aeterna-institute.org/api/v1/words?lemma=arma"

const res = await fetch("https://interlinea.aeterna-institute.org/api/v1/words?lemma=arma")
const data = await res.json()
console.log(data)

import json
from urllib.request import urlopen

with urlopen("https://interlinea.aeterna-institute.org/api/v1/words?lemma=arma") as res:
    data = json.load(res)

print(data)

Example response

Response200 OK

{
  "lemma": "arma",
  "lang": "la",
  "entries": [
    {
      "lemma": "arma",
      "entry": "arma, armōrum n. pl.",
      "upos": "NOUN",
      "glosses": [
        "arms",
        "the arms"
      ],
      "count": 2
    }
  ],
  "occurrences": [
    {
      "form": "Arma",
      "lemma": "arma",
      "upos": "NOUN",
      "feats": "Case=Acc|Gender=Neut|Number=Plur",
      "gloss": "arms",
      "sentence": "Arma virumque cano, Troiae qui primus ab oris\nItaliam, fato profugus, Laviniaque venit\nlitora, multum ille et terris iactatus et alto\nvi sup…",
      "translation": "I sing of arms and a man, who first, an exile by fate, came from the shores of Troy to Italy and the Lavinian shores, that man having been t…",
      "citation": "Virgil, Aeneid 1.1–11",
      "url": "https://interlinea.aeterna-institute.org/read/latin/virgil-aeneid",
      "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/virgil-aeneid",
      "license": "CC BY-SA 4.0"
    },
    {
      "form": "arma",
      "lemma": "arma",
      "upos": "NOUN",
      "feats": "Case=Nom|Gender=Neut|Number=Plur",
      "gloss": "the arms",
      "sentence": "et Pompei Crassique potentia cito in Caesarem, Lepidi atque Antonii arma in Augustum cessere, qui cuncta discordiis civilibus fessa nomine p…",
      "translation": "And the power of Pompey and Crassus quickly passed to Caesar, and the arms of Lepidus and Antony passed to Augustus, who received all things…",
      "citation": "Tacitus, Annales 1.1",
      "url": "https://interlinea.aeterna-institute.org/read/latin/tacitus-annals",
      "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/tacitus-annals",
      "license": "CC BY-SA 4.0"
    }
  ],
  "credits": [
    "Virgil, Aeneid 1.1–11. CC BY-SA 4.0. Perseus Digital Library (Tufts University), PerseusDL/canonical-latinLit; edition: J. B. Greenough, Gin…",
    "Tacitus, Annales 1.1. CC BY-SA 4.0. Perseus Digital Library (Tufts University), PerseusDL/canonical-latinLit; edition: C. D. Fisher, Oxford…"
  ],
  "note": "From stored analyses only: the graded passages and the library sections readers have opened. Accents, breathings and macrons are ignored whe…"
}

Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=86400

Try it

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

Parameters#

Response#

Errors#

Example request#

Example response#