Developers
Структурированные веб-результаты за один запрос
Публичный поисковый эндпоинт работает без регистрации и API-ключа. Скудные локальные результаты могут дополняться явно помеченным внешним источником; полный контент доступен только для локально проиндексированных результатов.
1. Сделайте первый запрос
q — единственный обязательный параметр. Публичному уровню не нужен заголовок Authorization; подходит для оценки и малых объёмов.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Правильно обрабатывайте источники и контент
source=local — из индекса TutuSoo; source=brave — веб-фолбэк при слабом локальном покрытии.
- Используйте возвращённый url для перехода; никогда не выводите внешний адрес из id.
- Вызывайте /api/v1/content/{id} только для локальных результатов с непустым id.
- Обрабатывайте 429, тайм-ауты, офлайн-состояния и пустые результаты без бесконечных повторов.
3. Пагинация и лимиты ресурсов
Веб-интерфейс показывает 10 результатов на страницу и ограничивает глубокую пагинацию. API ограничивает длину запроса, число результатов и допустимую глубину, чтобы один запрос не монополизировал ресурсы поиска.
- Запросы ограничены 512 символами.
- limit ограничен 100; рекомендуется 10–20.
- time_range фильтрует по времени обхода/индексации TutuSoo, а не по дате публикации страницы.
- Для ответов 429 или 503 применяйте ограниченный экспоненциальный бэкофф, чтобы избежать шторма повторов.