Skip to content

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.

GET/searchguest
Search page

Fast multi-provider web search on submit.

curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/search'
GET/deepsearchguest
Deepsearch page

Iterative research with graded sources and a written answer.

curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch'
GET/deepresearchguest
Deepresearch page

Live-streamed deep research with thinking trace and growing answer.

curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepresearch'
GET/search/apiguest
Search API

Proxies rsearch search. Query plus count, content, and cache flags. Answers results plus a telemetry envelope.

FieldTypeLocationRequired
qstringqueryyes
countstringqueryno
contentstringqueryno
cachestringqueryno
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/search/api?q=python+asyncio'
GET/deepsearch/apiguest
Deepsearch API

Proxies rsearch deep research. Answers graded sources, markdown, rounds, plus a telemetry envelope. Runs fresh work unless cache=true replays a stored answer.

FieldTypeLocationRequired
qstringqueryyes
countstringqueryno
cachestringqueryno
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch/api?q=sodium+battery+state+of+the+art'
GET/deepsearch/streamguest
Deepsearch stream

Server-sent stream: telemetry keep-alive while rsearch runs, then the result plus done, or error. The Deepsearch page always asks for cache=false.

FieldTypeLocationRequired
qstringqueryyes
countstringqueryno
cachestringqueryno
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepsearch/stream?q=sodium+battery+state+of+the+art'
GET/deepresearch/streamguest
Deepresearch stream

Server-sent stream: think, answer, sources, usage, telemetry, cost, then done or error.

FieldTypeLocationRequired
qstringqueryyes
curl -X GET -H 'Accept: application/json' 'https://molodetz.nl/deepresearch/stream?q=quantum+computing+breakthroughs'
40.3ms