curl --request POST \
--url https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"method": "hybrid",
"page": 1,
"top_k": 10,
"score_threshold": 123,
"include": [],
"boost_tag_ids": [],
"filters": {
"category_id": "<string>",
"tag_ids": []
}
}
'import requests
url = "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search"
payload = {
"query": "<string>",
"method": "hybrid",
"page": 1,
"top_k": 10,
"score_threshold": 123,
"include": [],
"boost_tag_ids": [],
"filters": {
"category_id": "<string>",
"tag_ids": []
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
method: 'hybrid',
page: 1,
top_k: 10,
score_threshold: 123,
include: [],
boost_tag_ids: [],
filters: {category_id: '<string>', tag_ids: []}
})
};
fetch('https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'method' => 'hybrid',
'page' => 1,
'top_k' => 10,
'score_threshold' => 123,
'include' => [
],
'boost_tag_ids' => [
],
'filters' => [
'category_id' => '<string>',
'tag_ids' => [
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}"
response = http.request(request)
puts response.read_body{
"request_id": "<string>",
"data": {
"hits": [
{
"object": "topic",
"id": "<string>",
"doc_id": "<string>",
"kb_id": "<string>",
"name": "<string>",
"score": 123,
"retrieval_method": "keyword",
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"category_id": "",
"category_name": "<string>",
"depth": 0,
"summary": "<string>",
"content": "<string>",
"source": "<string>",
"document": {
"doc_id": "<string>",
"title": "",
"summary": "<string>"
},
"updated_at": "2023-11-07T05:31:56Z"
}
],
"total": 123,
"took_ms": 123
}
}{}{}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{}{}Search a knowledge base
Search within one knowledge base, by keyword, vector or hybrid retrieval.
The unit of retrieval is the topic, not the document: each hit carries its parent document’s title and summary, so rendering a result needs no second call.
Topic bodies are omitted by default — ask for content in include to inline them, or drill down with GET …/documents//topics/.
curl --request POST \
--url https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"method": "hybrid",
"page": 1,
"top_k": 10,
"score_threshold": 123,
"include": [],
"boost_tag_ids": [],
"filters": {
"category_id": "<string>",
"tag_ids": []
}
}
'import requests
url = "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search"
payload = {
"query": "<string>",
"method": "hybrid",
"page": 1,
"top_k": 10,
"score_threshold": 123,
"include": [],
"boost_tag_ids": [],
"filters": {
"category_id": "<string>",
"tag_ids": []
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
method: 'hybrid',
page: 1,
top_k: 10,
score_threshold: 123,
include: [],
boost_tag_ids: [],
filters: {category_id: '<string>', tag_ids: []}
})
};
fetch('https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'method' => 'hybrid',
'page' => 1,
'top_k' => 10,
'score_threshold' => 123,
'include' => [
],
'boost_tag_ids' => [
],
'filters' => [
'category_id' => '<string>',
'tag_ids' => [
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evermind.ai/api/v2/knowledge_bases/{kb_id}/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"method\": \"hybrid\",\n \"page\": 1,\n \"top_k\": 10,\n \"score_threshold\": 123,\n \"include\": [],\n \"boost_tag_ids\": [],\n \"filters\": {\n \"category_id\": \"<string>\",\n \"tag_ids\": []\n }\n}"
response = http.request(request)
puts response.read_body{
"request_id": "<string>",
"data": {
"hits": [
{
"object": "topic",
"id": "<string>",
"doc_id": "<string>",
"kb_id": "<string>",
"name": "<string>",
"score": 123,
"retrieval_method": "keyword",
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"category_id": "",
"category_name": "<string>",
"depth": 0,
"summary": "<string>",
"content": "<string>",
"source": "<string>",
"document": {
"doc_id": "<string>",
"title": "",
"summary": "<string>"
},
"updated_at": "2023-11-07T05:31:56Z"
}
],
"total": 123,
"took_ms": 123
}
}{}{}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{}{}Authorizations
API key issued by EverOS, sent as Authorization: Bearer <api_key>.
Path Parameters
Body
POST body (kb_id rides the path, not the body).
What to retrieve against within this knowledge base, up to 2000 characters. Optional: omit it and pass filters.tag_ids to page through tagged topics instead, which skips retrieval entirely — every hit then scores 0.0.
2000Retrieval strategy: "keyword" (lexical), "vector" (embedding similarity) or "hybrid" (default, both).
keyword, vector, hybrid Filter-only page number; query search supports page 1 only
x >= 1Maximum number of topics to return, 1 to 100 (default 10). On a query search the server also bounds the result by its rerank pool — 50 candidates by default — so asking for more than that returns what the pool held. On a filter-only request (tags without a query) it is the page size instead, and page walks the rest.
1 <= x <= 100Drop hits whose final score is below this. Mind what that score is: it is normalized within each response (see score on a hit), so this cuts a RELATIVE position in one result set, not an absolute relevance bar — a response whose hits are all poor still has a top hit near the top of the range. Two traps follow from the edge values: a filter-only request scores every hit 0.0, so any positive threshold empties it, and a failed rerank batch scores -100.0, which every positive threshold silently removes. Tune it against real results rather than from a BM25 or cosine intuition.
e.g. ['content']
Reweight, do not filter: topics carrying these tags are pushed up, and topics without them still come back. Use filters.tag_ids when the intent is to exclude everything else.
100Opaque semantic tag id
1 - 128Optional filters narrowing what is searched.
Show child attributes
Show child attributes
Was this page helpful?

