Developers
Des résultats web structurés en une requête
Le point d’accès de recherche public fonctionne sans inscription ni clé API. Des résultats locaux clairsemés peuvent être complétés par une source externe clairement étiquetée ; le contenu complet n’est disponible que pour les résultats indexés localement.
1. Effectuez votre première requête
q est le seul paramètre requis. Le palier public ne nécessite pas d’en-tête Authorization et convient à l’évaluation et à un faible volume.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Gérez correctement sources et contenu
source=local provient de l’index TutuSoo ; source=brave est un repli web quand la couverture locale est faible.
- Utilisez l’url renvoyée pour la navigation ; ne dérivez jamais une adresse externe de l’id.
- Appelez /api/v1/content/{id} uniquement pour les résultats locaux avec un id non vide.
- Gérez 429, délais d’attente, états hors ligne et résultats vides sans réessais infinis.
3. Pagination et limites de ressources
L’interface web affiche 10 résultats par page et limite la pagination profonde. L’API limite la longueur de requête, le nombre de résultats et la profondeur acceptée afin qu’une requête ne monopolise pas les ressources.
- Les requêtes sont limitées à 512 caractères.
- limit est plafonné à 100 ; 10–20 est recommandé.
- time_range filtre selon l’heure de crawl/indexation de TutuSoo, pas la date de publication de la page.
- Utilisez un backoff exponentiel borné pour les réponses 429 ou 503 afin d’éviter les tempêtes de réessais.