Developers
Strukturierte Web-Ergebnisse in einer Anfrage
Der öffentliche Such-Endpunkt funktioniert ohne Registrierung oder API-Key. Spärliche lokale Ergebnisse können durch eine klar gekennzeichnete externe Quelle ergänzt werden; vollständiger Inhalt nur für lokal indexierte Ergebnisse.
1. Erste Anfrage stellen
q ist der einzige Pflichtparameter. Die öffentliche Stufe braucht keinen Authorization-Header und eignet sich für Evaluierung und geringes Volumen.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Quellen und Inhalte korrekt behandeln
source=local stammt aus dem TutuSoo-Index; source=brave ist ein Web-Fallback bei geringer lokaler Abdeckung.
- Verwenden Sie die zurückgegebene url zur Navigation; leiten Sie nie eine externe Adresse aus der id ab.
- Rufen Sie /api/v1/content/{id} nur für lokale Ergebnisse mit nicht leerer id auf.
- Behandeln Sie 429, Timeouts, Offline-Zustände und leere Ergebnisse ohne endlose Wiederholungen.
3. Paginierung und Ressourcenlimits
Die Web-Oberfläche zeigt 10 Ergebnisse pro Seite und begrenzt tiefe Paginierung. Die API begrenzt Abfragelänge, Ergebnisanzahl und akzeptierte Tiefe, damit eine Anfrage die Suchressourcen nicht monopolisiert.
- Abfragen sind auf 512 Zeichen begrenzt.
- limit ist auf 100 begrenzt; 10–20 wird empfohlen.
- time_range filtert nach TutuSoos Crawl-/Index-Zeit, nicht nach dem Veröffentlichungsdatum der Seite.
- Verwenden Sie begrenztes exponentielles Backoff bei 429- oder 503-Antworten, um Retry-Stürme zu vermeiden.