Filtrer og avgrens søket

/documents/search kjører fulltekstsøk på tittelen og innholdet i dokumentene dine og returnerer de beste treffene, hver med en relevansscore og kildedokumentet det kom fra. Denne veiledningen viser hvordan du kan avgrense disse resultatene med filtre og hvordan du leser responsen.

Forespørselen

Bare query er påkrevd. Alt annet avgrenser eller begrenser resultatene.

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"
  }'

Responsen

{
  "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
}

Hvert resultat inneholder en snippet med den matchende teksten, en score fra 0 til 1 (høyere er mer relevant), og kildedokumentets metadata slik at du kan spore det tilbake. totalCount er hvor mange dokumenter som totalt samsvarte, noe som kan være større enn antallet results du ba om med limit.

Lesing av resultatene

• Resultatene rangeres etter relevans, med mest relevante først. Bruk score til å bestemme en grense hvis du bare vil ha sterke treff.
• totalCount vs results.length: results inneholder opptil limit elementer; totalCount er det totale antallet treff. Hvis totalCount er mye større enn limit, stram inn query eller legg til et filter i stedet for å forvente alle treff tilbake i én kall.
• Bare indekserte dokumenter er søkbare. Et dokument med status av processing eller failed er ikke søkbart ennå. Se Dokumenter og søk for livssyklusen.

Neste steg