---
title: "Vector/Hybrid search"
method: POST
path: "/retriever"
tags: ["Retriever"]
---

# Vector/Hybrid search

`POST /retriever`

## Request body

- RetrieverRequest
  - `text` string, required — Search query
  - `d_app_id` string
  - `project_id` string
  - `limit` integer
  - `search_mode` 'vector' | 'hybrid' | 'hybrid_rrf'
  - `files_directories` string[]
  - `file_paths` string[]
  - `documents_id` string[]
  - `vector_weight` number
  - `text_weight` number
  - `rrf_k` integer
  - `enable_phrase_matching` boolean

## Response `200`

Search results

- RetrieverResponse
  - `query` string
  - `d_app_id` string
  - `project_id` string
  - `total_results` integer
  - `total_unfiltered_results` integer
  - `filtered_directories` string[]
  - `filtered_file_paths` string[]
  - `results` RetrieverHit[]
    - `id` string
    - `text` string
    - `score` number
    - `metadata` RetrieverHitMetadata
      - `source` string
      - `directory` string
      - `file_path` string
      - `chunk_index` integer
      - `page_range` string
      - `start_page` integer
      - `end_page` integer
      - `chunk_category` string
      - `document_id` string
      - `vector_score` number
      - `text_score` number
      - `text_rank` number

---

[API](https://skmtc.net/j-aic/apis/ib-link-apis.md) · [All operations](https://skmtc.net/j-aic/apis/ib-link-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/j-aic/ib-link-apis/revisions/27f7c6c98b23/schema)