Gère les fiches d'outils par programmation. Les endpoints d'écriture sont limités à 60 requêtes par minute et par IP.
API de lecture pour agents IA
Publique, anonyme et en lecture seule. Les endpoints renvoient les outils publiés sous forme de JSON stable, avec une limite de 120 requêtes par 60 s et par IP.
Aucune clé API ni token Bearer n’est nécessaire. N’envoie jamais la clé de publication ici.
GET https://www.getsitools.com/api/public/toolsLister ou rechercher les outils publiés, avec pagination, tri et filtres par catégorie ou tag.
GET https://www.getsitools.com/api/public/tools/{slug}Un outil par slug, avec captures d’écran, langues prises en charge et couverture par locale.
GET https://www.getsitools.com/api/public/categoriesL’arborescence des catégories pour une locale, avec le nombre d’outils publiés.
llms.txt — llms.txt – résumé du site pour les agents IA
llms-full.txt — llms-full.txt – tous les outils publiés avec un résumé en une ligne
Authentification
Envoie ta clé de publication comme token Bearer sur chaque requête. Garde la clé sur ton serveur et ne l'expose jamais dans du code client.
Authorization: Bearer <PUBLISH_API_KEY>
Définis PUBLISH_API_KEY sur le serveur. Si elle n'est pas définie, l'API renvoie 503 au lieu d'accepter des écritures non authentifiées.
Limites de débit
Les limites s'appliquent par adresse IP et par portée de route. Lecture et écriture utilisent des seaux séparés : beaucoup de lectures n'épuisent pas le quota d'écriture.
Endpoints de lecture: 120 / 60s
Endpoints d'écriture: 60 / 60s
Chaque réponse inclut RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Une réponse 429 inclut aussi Retry-After.
Points de terminaison
Les exemples ci-dessous utilisent $PUBLISH_API_KEY. Remplace le marqueur d'id d'outil par l'id renvoyé par l'endpoint de création.
POST/api/v1/tools/submit-url
Envoyer une URL
Envoie simplement une URL. Le collecteur récupère les données du site, les traduit et publie la fiche. Vérification gratuite sans intervention manuelle.
Seules les URL HTTP/HTTPS sont acceptées. Une réponse en file signifie que l’URL a été acceptée dans la file du collecteur.
{
"id": "submission_abc123",
"submissionId": "submission_abc123",
"status": "queued",
"duplicate": false,
"message": "URL submitted successfully. The collector will scrape and process it automatically."
}
Réponses d'erreur
Les erreurs sont renvoyées en JSON avec un code stable et un message lisible.
Statut
Code d’erreur
Signification
400
VALIDATION_ERROR
Le corps de la requête ou les paramètres sont invalides.
401
UNAUTHORIZED
Le token Bearer est absent ou incorrect.
404
NOT_FOUND
L'outil demandé n'existe pas.
422
LOCALES_INCOMPLETE
Des champs de langues obligatoires manquent, l'outil ne peut pas être publié.
429
RATE_LIMITED
Limite de débit dépassée. Réessaie après la fenêtre Retry-After (environ 60 s).
503
API_KEY_NOT_CONFIGURED
Le serveur n'a pas de PUBLISH_API_KEY, les écritures sont désactivées.