Filtra e affina la ricerca
Restringi una ricerca di documenti con i filtri di fonte, fornitore e data, e leggi i risultati classificati.
/documents/search esegue una ricerca full-text sui titoli e sui contenuti dei tuoi documenti e restituisce le corrispondenze migliori, ognuna con un punteggio di rilevanza e il documento sorgente da cui proviene. Questa guida mostra come restringere tali risultati con i filtri e come interpretare la risposta.
La richiesta
Solo query è obbligatorio. Tutto il resto restringe o limita i risultati.
curl https://nordvec.com/api/v1/documents/search \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "renewal terms",
"limit": 20,
"datasource": "contracts",
"sourceProvider": "google_drive",
"createdAfter": "2026-01-01T00:00:00Z",
"createdBefore": "2026-07-01T00:00:00Z"
}'| Campo | Tipo | Note |
|---|---|---|
query | string | Obbligatorio. Da 1 a 500 caratteri. |
limit | integer | Opzionale. Da 1 a 50. Quanti risultati restituire (viene applicato il valore predefinito se omesso). |
datasource | string | Opzionale. Limita a una singola datasource (fino a 100 caratteri). |
sourceProvider | string | Opzionale. Limita a un singolo provider di connettore, ad esempio la sorgente da cui un documento è stato sincronizzato. |
createdAfter | string | Opzionale. Timestamp ISO 8601; solo documenti creati in questa data o successivamente. |
createdBefore | string | Opzionale. Timestamp ISO 8601; solo documenti creati prima di questa data. |
Ogni filtro è combinato con AND: un documento deve corrispondere alla query e a ogni filtro che fornisci. Ometti un filtro per ampliare la ricerca.
La risposta
{
"results": [
{
"id": "…",
"title": "Acme Corp Master Services Agreement",
"snippet": "…renews automatically for successive twelve month terms…",
"score": 0.82,
"datasource": "contracts",
"source_provider": "google_drive",
"source_type": "…",
"mime_type": "application/pdf",
"status": "indexed",
"created_at": "2026-02-14T09:00:00Z",
"updated_at": "2026-02-14T09:00:00Z"
}
],
"totalCount": 7
}Ogni risultato include un snippet con il testo corrispondente, un score da 0 a 1 (più alto è il valore, maggiore è la rilevanza), e i metadati del documento sorgente in modo da poterlo rintracciare. totalCount indica quanti documenti corrispondono in totale, che può essere un numero maggiore rispetto ai results che hai richiesto con limit.
Interpretazione dei risultati
- I risultati sono ordinati per rilevanza, dal più rilevante al meno rilevante. Usa
scoreper decidere un punto di taglio se vuoi solo corrispondenze forti. totalCountvsresults.length:resultscontiene fino alimitelementi;totalCountè il conteggio totale delle corrispondenze. SetotalCountè molto più grande del tuolimit, restringi laqueryo aggiungi un filtro invece di aspettarti di ricevere tutte le corrispondenze in una singola chiamata.- Solo i documenti indicizzati sono ricercabili. Un documento con
statuspari aprocessingofailednon è ancora recuperabile; consulta Documenti e ricerca per il ciclo di vita.
La ricerca restituisce solo i documenti che l'utente è autorizzato a vedere. L'accesso è applicato a livello di dati, non nel codice dell'applicazione, quindi un filtro non può mai ampliare la tua visibilità oltre i tuoi documenti.