Guida rapida Search API

Esegui ricerche neurali o per parole chiave sulla tua Libreria dalla riga di comando o qualsiasi client HTTP.

21 mag 2026

La Search API fornisce accesso programmato allo stesso motore di recupero che alimenta la Ricerca e la Chat di Vulgate. Puoi eseguire ricerche neurali (basate sul significato) e per parole chiave (corrispondenza letterale), con filtri opzionali per autore, anno di pubblicazione, ISBN e ID del documento.

Il riferimento completo si trova in /developers/search/overview. Questa guida copre i pattern più comuni.

Ricerca neurale

Trova passaggi il cui significato corrisponde a una query:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=early church councils on civic authority" \
  --data-urlencode "mode=neural" \
  --data-urlencode "per_page=5"

Risposta (troncata):

{
  "data": [
    {
      "id": "part-abc123",
      "document_id": "doc-xyz789",
      "index": "urn:vulgate:doc-xyz789:42",
      "content_rendered": "<p>The fathers reasoned that civic governance...</p>",
      "language": "en",
      "namespace": "mai",
      "documents": {
        "id": "doc-xyz789",
        "title": "The Council of Nicaea",
        "author": "...",
        "publication_date": "1995",
        "document_format": "PDF",
        "scope": "organization"
      }
    }
  ],
  "count": 42,
  "error": null
}

Ricerca per parole chiave

Trova passaggi che contengono le parole letterali. Imposta mode=keyword:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=Constantine" \
  --data-urlencode "mode=keyword" \
  --data-urlencode "per_page=10"

Filtraggio

Aggiungi filtri tramite parametri query:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=grace" \
  --data-urlencode "author=Augustine" \
  --data-urlencode "mode=neural"

Filtri disponibili: author, publication_date (anno), isbn, id (ID documento per corrispondenza esatta) e document_id (per cercare all'interno di un singolo documento).

Scegliere le librerie

Il parametro query libraries limita la ricerca a una o più Librerie. Passalo come parametro query ripetuto:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=liturgical calendar" \
  --data-urlencode "libraries=mai" \
  --data-urlencode "libraries=orientale"

Se libraries viene omesso, l'API usa per impostazione predefinita la tua libreria privata.

Cercare documenti (non passaggi)

Per elencare documenti che corrispondono per titolo invece di restituire singoli passaggi, usa /api/search/documents:

curl -G "https://vulgate.ai/api/search/documents" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=Eucharist" \
  --data-urlencode "per_page=20"

Paginazione

Usa page (indicizzato da 1) e per_page (max 100) per navigare il set di risultati:

?search=theology&per_page=20&page=2

Il campo count della risposta è un totale stimato — adatto per le UI di paginazione.

Correlati

Cerca nell'assistenza