VDL – DanteSearch

Questa API permette di interrogare il corpus di DanteSearch effettuando una ricerca per lemma.

Istruzioni per l'utilizzo

Per eseguire una ricerca, collegarsi all'URL http://vdl.isti.cnr.it/dsapi/ seguito dal lemma che si vuole cercare. Ad esempio, volendo cercare il lemma mezzo, l'URL da caricare è: http://vdl.isti.cnr.it/dsapi/mezzo

Parametri

È possibile restringere la ricerca alle opere in latino, oppure a quelle in volgare, tramite il parametro lang.

Parametro	Descrizione	Valori	Esempio
lang	lingua dell'opera	la (latino) it (volgare)	http://vdl.isti.cnr.it/dsapi/vita?lang=la

Risultati

I risultati sono restituiti in formato JSON e hanno la seguente struttura:

Campo	Descrizione	Esempio
lemma	lemma cercato	mezzo
occorrenze per opera	numero di occorrenze per ciascuna opera dantesca in cui il lemma è stato trovato	"Commedia - Inferno": 16, "Commedia - Paradiso": 17, "Commedia - Purgatorio": 20, "Convivio": 46, "Le Rime": 5, "Vita Nuova": 8
occorrenze totali	totale delle occorrenze del lemma trovate nell'intero corpus di DanteSearch	112
risultati	lista dei risultati	[{"contesto": "per lo suo mezzo cerchio...", "forma": ...}, ...]

A sua volta, ogni risultato presente nella lista dei risultati contiene i seguenti campi:

Campo	Descrizione	Esempio
contesto	contesto in cui si trova la forma (evidenziata dal tag <i>)	per lo suo <i>mezzo<\i> cerchio a l'altra giostra
forma	forma del lemma cercato	mezzo
link	link alla ricerca sul sito di DanteSearch	https://dantesearch.dantenetwork.it/api.html?lemma=mezzo
luogo	luogo dell'opera in cui si trova la forma	Inf. VII 35
opera	opera dantesca in cui il lemma è usato	Commedia - Inferno
posizione	posizione nella lista dei risultati	97