La ricerca dei dati nel RNDT è possibile anche tramite API REST. Per interrogare il Catalogo, l’URL da utilizzare è il seguente:
https://geodati.gov.it/RNDT/rest/metadata/search? <parametro>&<parametro>&…
dove <parametro> è uno dei parametri REST disponibili. Di seguito sono elencati quelli principali.
| Parametro | Descrizione | Valori accettati |
| bbox | Estensione indicata come due coppie di coordinate (ovest-sud e est-nord). | Valori di latitudine e longitudine separati da virgole. |
| q | Testo. | Stringa. E' possibile comporre la stringa di ricerca utilizzando tutti gli elementi indicizzati (vedi dopo), wildchars e operatori booleani. |
| dataCategory | Categoria tematica del dataset, definita nello Standard ISO 19115 (enumerazione TopicCategoryCode). | Valori separati da virgola. |
| time | Date per identificare un intervallo temporale. | Inizio/fine entrambe date nel formato yyyy-mm-dd |
| sort | Ordinamento risultati. | Uno fra: dateAscending, dateDescending (default), relevance, title. |
| start | Numero del primo record da considerare. | Intero. Se utilizzato insieme al parametro max, fornisce l'impaginazione dei risultati della ricerca. |
| num | Numero massimo di risultati. | Interno. Valore massimo: 5000, default: 10. Se utilizzato insieme al parametro start, fornisce l'impaginazione dei risultati della ricerca. |
| f | Formato della risposta. | Un valore fra: atom, json, csw, rss, csv, kml, eros, json-source. |
Per maggiori dettagli fare riferimento alla pagina REST API Syntax del sito di test del geoportal-server.
Il motore di ricerca è basato su Elastic Search, un potente motore di ricerca e analisi che a sua volta utilizza il motore Apache Lucene.
Per sfruttare al meglio la ricerca, può essere utile conoscere la sintassi delle query Apache Lucene per le ricerche di testo.
Gli elementi interrogabili da utilizzare nelle ricerche nel RNDT sono visualizzabili nella risposta JSON interrogando un qualunque metadato; essi includono i criteri di ricerca indicati nelle linee guida INSPIRE sui servizi di ricerca.. Per esempi di uso è possibile utilizzare la Ricerca Dettagliata impostando i filtri di interesse, poi sulla pagina di Anteprima cliccare sul simbolo del link e copiare e incollare il testo in un browser.
Di seguito si riportano alcuni esempi esplicativi.
ESEMPIO 1
Ricerca di tutti i dati che hanno come tema INSPIRE Idrografia (1=INSPIRETheme_s:Idrografia). INSPIRETheme_s è uno dei criteri di ricerca. La ricerca è limitata ai primi 300 record (start=1 e num=300) e i risultati visualizzati in formato json (f=json) con ordinamento basato sul titolo.
ESEMPIO 2
Ricerca di tutti i dati che contengono le parole "carta" e "geologica" nel titolo, con massimo 50 risultati (num=50) a cominciare dal 20° record (start=20) visualizzati in HTML (f=html) ordinati secondo il titolo stesso (sort=title).
Si possono avere più casi.
Se il testo viene inserito tra virgolette (q=title:"carta geologica"), la ricerca restituisce tutti i record che contengono esattamente il testo inserito (le due parole una dopo l'altra così come inserite).
Se le due parole sono inserite senza virgolette (q=title:carta geologica), la ricerca restituisce tutti i record che contengono "carta" nel titolo e "geologica" in qualsiasi campo, in quanto, quando non specificato, il criterio di default è text. Da notare le parentesi per evitare che "geologica" venga interpretato per un parametro.
https://geodati.gov.it/RNDT/rest/metadata/search?q=(title:carta geologica)&start=20&num=50&f=html&sort=title:desc
Se le due parole sono inserite con l'operatore AND (q=title:carta AND geologica), la ricerca restituisce tutti i record che contengono entrambe le parole (non necessariamente una dopo l'altra così come inserite).
https://geodati.gov.it/RNDT/rest/metadata/search?q=title:(carta AND geologica)&start=20&num=50&f=html&sort=title:desc
ESEMPIO 3
Esempio con l'utilizzo di operatori jolly e operatori di inclusione/esclusione. Ricerca dei primi 50 metadati (start=1 e num=50) che contengono la parola "suolo" e non contengono la parola "natura" (-natura). Risultati ordinati secondo il titolo (sort=title:desc) e risposta in formato json (f=json).
Ricerca come sopra, ma con metadati contenenti la stringa "suo" (*suo*) e non contenenti parole che iniziano con la sillaba "na" seguita da due caratteri e che finiscono con la sillaba "ra" (na??ra)
ESEMPIO 4
Ricerca di uno specifico record tramite l'ID del file di metadati (id) che ritorna l'XML del metadato.
https://geodati.gov.it/RNDT/rest/metadata/search?id=ispra_rm:0029CNATHB_DT