API: Search
Three search modes over the rsearch backend: instant search, graded deepsearch, streamed deepresearch.
Every HTML route returns JSON with Accept: application/json. Authentication: session cookie, X-API-KEY, Authorization: Bearer or Basic.
/searchguestFast multi-provider web search on submit.
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/search'
const response = await fetch("/search", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/search", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"mode": "search"
}
Not sent yet.
/deepsearchguestIterative research with graded sources and a written answer.
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch'
const response = await fetch("/deepsearch", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/deepsearch", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"mode": "deepsearch"
}
Not sent yet.
/deepresearchguestLive-streamed deep research with thinking trace and growing answer.
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepresearch'
const response = await fetch("/deepresearch", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/deepresearch", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"mode": "deepresearch"
}
Not sent yet.
/search/apiguestProxies rsearch search. Query plus count, content, and cache flags. Answers results plus a telemetry envelope.
| Field | Type | Location | Required |
|---|---|---|---|
q | string | query | yes |
count | string | query | no |
content | string | query | no |
cache | string | query | no |
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/search/api?q=python+asyncio'
const response = await fetch("/search/api", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/search/api", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"results": [],
"telemetry": {}
}
Not sent yet.
/deepsearch/apiguestProxies rsearch deep research. Answers graded sources, markdown, rounds, plus a telemetry envelope. Runs fresh work unless cache=true replays a stored answer.
| Field | Type | Location | Required |
|---|---|---|---|
q | string | query | yes |
count | string | query | no |
cache | string | query | no |
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch/api?q=sodium+battery+state+of+the+art'
const response = await fetch("/deepsearch/api", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/deepsearch/api", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"deep": {},
"telemetry": {}
}
Not sent yet.
/deepsearch/streamguestServer-sent stream: telemetry keep-alive while rsearch runs, then the result plus done, or error. The Deepsearch page always asks for cache=false.
| Field | Type | Location | Required |
|---|---|---|---|
q | string | query | yes |
count | string | query | no |
cache | string | query | no |
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch/stream?q=sodium+battery+state+of+the+art'
const response = await fetch("/deepsearch/stream", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/deepsearch/stream", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"event": "result"
}
/deepresearch/streamguestServer-sent stream: think, answer, sources, usage, telemetry, cost, then done or error.
| Field | Type | Location | Required |
|---|---|---|---|
q | string | query | yes |
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepresearch/stream?q=quantum+computing+breakthroughs'
const response = await fetch("/deepresearch/stream", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());
import httpx
print(httpx.request("GET", BASE + "/deepresearch/stream", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())
{
"event": "think"
}