Suodata ja tarkenna hakua

/documents/search suorittaa täystekstihakuja dokumenttiesi otsikoissa ja sisällöissä ja palauttaa parhaat osumat, joista jokaisessa on relevanssipisteet ja lähdedokumentti, josta se on peräisin. Tämä opas näyttää, miten voit rajata näitä tuloksia suodattimilla ja miten vastaus luetaan.

Pyyntö

Vain query on pakollinen. Kaikki muu rajaa tai määrittää tuloksia.

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

Vastaus

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

Jokainen tulos sisältää snippet:n, jossa on osuva teksti, score:n välillä 0–1 (suurempi luku tarkoittaa suurempaa relevanssia) ja lähdedokumentin metatiedot, jotta voit jäljittää sen. totalCount kertoo, kuinka monta dokumenttia vastasi hakua yhteensä, mikä voi olla suurempi kuin results:iden määrä, jonka pyysit limit:lla.

Tulosten lukeminen

• Tulokset on järjestetty relevanssin mukaan, tärkeimmät ensin. Käytä score:tä päättääksesi katkaisukohdan, jos haluat vain vahvat osumat.
• totalCount vs results.length: results sisältää enintään limit kohdetta; totalCount on täydellinen osumamäärä. Jos totalCount on paljon suurempi kuin limit, tiukenna query:tä tai lisää suodatin sen sijaan, että odottaisit kaikkien osumien palautuvan yhdellä kutsulla.
• Vain indeksoidut dokumentit ovat haettavissa. Dokumenttia, jonka status on processing tai failed, ei ole vielä haettavissa. Katso lisätietoja dokumenttien elinkaarestä kohdasta Dokumentit ja haku.

Seuraavat vaiheet