Developers
Hasil web terstruktur dalam satu permintaan
Endpoint pencarian publik bekerja tanpa registrasi atau API key. Hasil lokal yang tipis dapat dilengkapi sumber eksternal berlabel jelas; konten penuh hanya untuk hasil terindeks lokal.
1. Buat permintaan pertama Anda
q adalah satu-satunya parameter wajib. Tingkat publik tidak butuh header Authorization dan cocok untuk evaluasi serta penggunaan volume rendah.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Tangani sumber dan konten dengan benar
source=local berasal dari indeks TutuSoo; source=brave adalah fallback web saat cakupan lokal tipis.
- Gunakan url yang dikembalikan untuk navigasi; jangan pernah menurunkan alamat eksternal dari id.
- Panggil /api/v1/content/{id} hanya untuk hasil lokal dengan id tidak kosong.
- Tangani 429, timeout, status offline, dan hasil kosong tanpa percobaan ulang tak terbatas.
3. Paginasi dan batas sumber daya
UI web menampilkan 10 hasil per halaman dan membatasi paginasi dalam. API membatasi panjang kueri, jumlah hasil, dan kedalaman yang diterima agar satu permintaan tak memonopoli sumber daya pencarian.
- Kueri dibatasi 512 karakter.
- limit dibatasi 100; disarankan 10–20.
- time_range memfilter berdasarkan waktu crawl/indeks TutuSoo, bukan tanggal terbit halaman.
- Gunakan exponential backoff terbatas untuk respons 429 atau 503 guna menghindari badai percobaan ulang.