Skip to content
Factflow

Search Keyword Only

POST
/api/v1/chat/search/keyword

Execute keyword-only full-text search.

Uses PostgreSQL’s tsvector with language-specific stemming. Useful for exact term matching when semantic similarity isn’t needed.

Args: request: Keyword search request service: Hybrid search service (injected)

Returns: Search results ranked by FTS score

Raises: HTTPException: 503 if service not configured

Request Body required

Section titled “Request Body required ”
KeywordSearchRequest

Request model for keyword-only search.

object
query
required
Query

Search query text

string
>= 1 characters <= 10000 characters
language
Language

Full-text search language

string
default: norwegian
Allowed values: norwegian english simple
execution_id
Any of:
string format: uuid
limit
Limit

Maximum results to return

integer
default: 10 >= 1 <= 100

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

RRFSearchResponse

Response model for RRF hybrid search.

object
results
required
Results
Array<object>
RRFResultModel

Single result from RRF hybrid search.

object
segment_id
required
Segment Id
string format: uuid
rrf_score
required
Rrf Score
number
content
required
Content
string
storage_key
required
Storage Key
string
language
required
Language
string
vector_similarity
required
Any of:
number
keyword_rank
required
Any of:
number
vector_rrf_contribution
required
Vector Rrf Contribution
number
keyword_rrf_contribution
required
Keyword Rrf Contribution
number
total_candidates
required
Total Candidates
integer
language
required
Language
string
search_time_ms
required
Search Time Ms
number
config
required
Config
object
key
additional properties
any

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object