Questa API permette di interrogare simultaneamente tutti i testi contenuti nel Corpus Corporum effettuando una ricerca per lemma.
Per eseguire una ricerca, collegarsi all'URL http://vdl.isti.cnr.it/search/ seguito dal lemma che si vuole cercare. Ad esempio, volendo cercare il lemma apparitio, l'URL da caricare è: http://vdl.isti.cnr.it/search/apparitio
| Parametro | Descrizione | Esempio di utilizzo |
|---|---|---|
from_year | anno inizio intervallo | from_year=1000 |
to_year | anno fine intervallo | to_year=1200 |
offset | pagina dei risultati | offset=500 |
La ricerca restituisce sempre i primi 500 risultati ordinati per nome dell'autore. Nel caso si vogliano ottenere i risultati successivi è necessario utilizzare il parametro offset in questo modo:
http://vdl.isti.cnr.it/search/apparitio?offset=500. In questo caso, inserendo come offset il valore 500, si otterranno i risultati dal numero 501 al numero 1000.
I risultati sono restituiti in formato JSON e hanno la seguente struttura:
| Campo | Descrizione | Esempio |
|---|---|---|
lemma | lemma cercato | apparitio |
occorrenze | numero di occorrenze | 1299 |
risultati | lista dei risultati | [{"posizione": "1", "link": ...}, ...] |
A sua volta, ogni risultato presente nella lista dei risultati contiene i seguenti campi:
| Campo | Descrizione | Esempio | |||
|---|---|---|---|---|---|
posizione | posizione nella lista dei risultati | 23 | |||
autore | nome dell'autore | Adamus Scotus | |||
titolo | titolo dell'opera | Sermones | |||
data | data indicativa di creazione dell'opera | auctor c.1140 | |||
riferimento | riferimento all'opera nel Corpus Corporum | PL 198, 0324A | |||
citazione | frammento di testo che contiene il lemma | Sic faciam sed exposita causa primae angeli appariti$
|