Developers
Resultados web estructurados en una sola solicitud
El endpoint de búsqueda público funciona sin registro ni API key. Los resultados locales escasos pueden complementarse con una fuente externa claramente etiquetada; el contenido completo solo está disponible para resultados indexados localmente.
1. Haz tu primera solicitud
q es el único parámetro obligatorio. El nivel público no necesita cabecera Authorization y sirve para evaluación y uso de bajo volumen.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Maneja fuentes y contenido correctamente
source=local proviene del índice de TutuSoo; source=brave es un respaldo web cuando la cobertura local es escasa.
- Usa la url devuelta para navegar; nunca derives una dirección externa del id.
- Llama a /api/v1/content/{id} solo para resultados locales con un id no vacío.
- Maneja 429, tiempos de espera, estados sin conexión y resultados vacíos sin reintentos infinitos.
3. Paginación y límites de recursos
La interfaz web usa 10 resultados por página y limita la paginación profunda. La API limita la longitud de consulta, el número de resultados y la profundidad aceptada para que una solicitud no monopolice los recursos.
- Las consultas se limitan a 512 caracteres.
- limit tiene un tope de 100; se recomienda 10–20.
- time_range filtra por la hora de rastreo/indexación de TutuSoo, no por la fecha de publicación de la página.
- Usa retroceso exponencial acotado para respuestas 429 o 503 y evita tormentas de reintentos.