Filtrer et affiner votre recherche
Affinez une recherche de documents avec les filtres de source, de fournisseur et de date, et lisez les résultats classés.
/documents/search effectue une recherche en texte intégral dans les titres et le contenu de vos documents et renvoie les meilleures correspondances, chacune avec un score de pertinence et le document source dont elle provient. Ce guide vous montre comment affiner ces résultats à l'aide de filtres et comment interpréter la réponse.
La requête
Seul query est obligatoire. Tout le reste permet de restreindre ou de limiter les résultats.
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"
}'| Champ | Type | Notes |
|---|---|---|
query | string | Obligatoire. De 1 à 500 caractères. |
limit | integer | Facultatif. De 1 à 50. Nombre de résultats à renvoyer (la valeur par défaut s'applique si omis). |
datasource | string | Facultatif. Restreint à une seule source de données (jusqu'à 100 caractères). |
sourceProvider | string | Facultatif. Restreint à un seul fournisseur de connecteur, par exemple la source depuis laquelle un document a été synchronisé. |
createdAfter | string | Facultatif. Horodatage ISO 8601 ; uniquement les documents créés à cette date ou après. |
createdBefore | string | Facultatif. Horodatage ISO 8601 ; uniquement les documents créés avant cette date. |
Chaque filtre est combiné avec un ET logique : un document doit correspondre à la requête et à chaque filtre que vous fournissez. Omettez un filtre pour élargir la recherche.
La réponse
{
"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
}Chaque résultat comprend un snippet avec le texte correspondant, un score allant de 0 à 1 (plus le score est élevé, plus la pertinence est grande), et les métadonnées du document source afin que vous puissiez le retracer. totalCount indique le nombre total de documents correspondants, qui peut être supérieur au nombre de results que vous avez demandé avec limit.
Lecture des résultats
- Les résultats sont classés par pertinence, du plus pertinent au moins pertinent. Utilisez
scorepour définir un seuil si vous ne souhaitez que des correspondances fortes. totalCountvsresults.length:resultscontient jusqu'àlimitéléments ;totalCountreprésente le nombre total de correspondances. SitotalCountest beaucoup plus grand que votrelimit, affinez laqueryou ajoutez un filtre plutôt que de vous attendre à recevoir toutes les correspondances en un seul appel.- Seuls les documents indexés sont recherchables. Un document avec un
statusdeprocessingoufailedn'est pas encore récupérable ; consultez Documents et recherche pour le cycle de vie.
La recherche ne renvoie jamais que les documents que vous êtes autorisé à voir. Les droits d'accès sont appliqués au niveau de la couche de données, et non dans le code applicatif, de sorte qu'un filtre ne peut jamais élargir votre visibilité au-delà de vos propres documents.