DumpAPI Reference
GET
curl
/api/search
Search the vault using hybrid full-text + semantic search with composite ranking.
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
q | string | — | Required. Search query |
source_type | string | — | Filter by source type |
category | string | — | Filter by category |
limit | number | 20 | Max results (max 100) |
Example
curl "http://localhost:3106/api/search?q=react+server+components&limit=10" \
-H "Authorization: Bearer YOUR_TOKEN"Response
{
"items": [
{
"id": "uuid",
"title": "Understanding RSC",
"source_type": "article",
"category": "Tech",
"_score": 0.87,
"...": "..."
}
],
"total": 15,
"rag": [
{
"chunkId": "uuid",
"documentId": "uuid",
"title": "React Docs",
"content": "Server Components allow...",
"similarity": 0.82
}
]
}Fields
| Field | Description |
|---|---|
items | Ranked search results with _score |
total | Total matches before ranking/limiting |
rag | Additional semantic matches from RAG index (deduplicated) |
Ranking
See Search feature docs for the full ranking formula and source weight table.
Status Codes
| Code | Description |
|---|---|
| 200 | Success |
| 400 | Missing q parameter |
| 401 | Unauthorized |
| 500 | Server error |