Developers
Resultados web estruturados em uma requisição
O endpoint de busca público funciona sem registro ou API key. Resultados locais escassos podem ser complementados por uma fonte externa claramente rotulada; o conteúdo completo só está disponível para resultados indexados localmente.
1. Faça sua primeira requisição
q é o único parâmetro obrigatório. O nível público não precisa de cabeçalho Authorization e serve para avaliação e uso de baixo volume.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Trate fontes e conteúdo corretamente
source=local vem do índice do TutuSoo; source=brave é um fallback web quando a cobertura local é escassa.
- Use a url retornada para navegar; nunca derive um endereço externo do id.
- Chame /api/v1/content/{id} apenas para resultados locais com id não vazio.
- Trate 429, timeouts, estados offline e resultados vazios sem tentativas infinitas.
3. Paginação e limites de recursos
A interface web usa 10 resultados por página e limita a paginação profunda. A API limita o comprimento da consulta, o número de resultados e a profundidade aceita para que uma requisição não monopolize os recursos.
- As consultas são limitadas a 512 caracteres.
- limit tem teto de 100; recomenda-se 10–20.
- time_range filtra pela hora de rastreio/indexação do TutuSoo, não pela data de publicação da página.
- Use backoff exponencial limitado para respostas 429 ou 503 e evite tempestades de retry.