Developers
Risultati web strutturati in una richiesta
L’endpoint di ricerca pubblico funziona senza registrazione o API key. Risultati locali scarsi possono essere integrati da una fonte esterna chiaramente etichettata; il contenuto completo è disponibile solo per i risultati indicizzati localmente.
1. Effettua la prima richiesta
q è l’unico parametro obbligatorio. Il livello pubblico non richiede l’header Authorization ed è adatto a valutazione e uso a basso volume.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Gestisci correttamente fonti e contenuti
source=local proviene dall’indice TutuSoo; source=brave è un fallback web quando la copertura locale è scarsa.
- Usa l’url restituito per la navigazione; non ricavare mai un indirizzo esterno dall’id.
- Chiama /api/v1/content/{id} solo per risultati locali con id non vuoto.
- Gestisci 429, timeout, stati offline e risultati vuoti senza retry infiniti.
3. Paginazione e limiti delle risorse
L’interfaccia web mostra 10 risultati per pagina e limita la paginazione profonda. L’API limita lunghezza query, numero di risultati e profondità accettata affinché una richiesta non monopolizzi le risorse.
- Le query sono limitate a 512 caratteri.
- limit è limitato a 100; consigliato 10–20.
- time_range filtra per l’ora di crawl/indicizzazione di TutuSoo, non per la data di pubblicazione della pagina.
- Usa backoff esponenziale limitato per le risposte 429 o 503 per evitare tempeste di retry.