API per agenti

Un agente passa direttamente i cursori, oppure lascia che il motore li imposti dal prompt. Nessuna registrazione, nessuna chiave, nessun pagamento alle fonti. Agents pass the sliders directly, or let the engine set them from the prompt. No sign-up, no key, no payments to sources.

Una chiamata, tutta la ricerca

GET /api/v1/search?q=studi verificati sulla dieta mediterranea

Senza cursori il motore tara da solo. Con i cursori decide l'agente: Without sliders the engine tunes itself; with sliders the agent decides:

GET /api/v1/search?q=dieta mediterranea&trust=-0.9&depth=0.6&n=5
GET /api/v1/search?q=granita siciliana&pos=last
GET /api/v1/search?q=produttori pistacchio&place=Bronte Sicilia&geo=-0.9&size=0.8
GET /api/v1/search?q=etna&lens=ultime-notizie

Cursori / Sliders

Parametro	−1	+1
`time` (`t`)	recente	consolidato
`size` (`s`)	grande fonte	voce piccola
`comm` (`c`)	commerciale	indipendente
`geo` (`g`) + `place`	vicino al luogo	ovunque
`depth` (`d`)	sintesi	approfondimento
`trust` (`v`)	solo verificato	qualsiasi
`pos`	posizione nello spazio dei risultati: da 1 a `total_estimated`, oppure `first`, `mid`, `last`

Cosa torna / Response

Per ogni risultato: titolo, indirizzo, fonte, data, verification (livello, punteggio, motivi), signals, il contributo di ogni cursore al punteggio e position_precision: exact, approx, sample o clamped. Le posizioni profonde sono stimate e lo dichiariamo sempre.

Altre rotte

/api/v1/tune?q= — solo taratura: dal prompt ai cursori
/api/v1/stream?q=&frac= — finestre per fonte in NDJSON
/api/v1/deep?rank= — web aperto per posizione (circa 30 miliardi di pagine)
/api/v1/sources, /api/v1/lenses, /api/v1/health
/api/v1/openapi.json · /llms.txt

Uso corretto: massimo 240 richieste al minuto per indirizzo. Prototipo: le rotte possono cambiare.