Aller au contenu

Développeurs

API publique

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.

Exemple

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — Définition OpenAPI 3.1
  • 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.

Requête

curl -X POST 'https://www.getsitools.com/en/api/v1/tools/submit-url' \
  -H 'Authorization: Bearer $PUBLISH_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com",
    "aiOnlyConfirmed": true
  }'

Réponse

{
  "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.

StatutCode d’erreurSignification
400VALIDATION_ERRORLe corps de la requête ou les paramètres sont invalides.
401UNAUTHORIZEDLe token Bearer est absent ou incorrect.
404NOT_FOUNDL'outil demandé n'existe pas.
422LOCALES_INCOMPLETEDes champs de langues obligatoires manquent, l'outil ne peut pas être publié.
429RATE_LIMITEDLimite de débit dépassée. Réessaie après la fenêtre Retry-After (environ 60 s).
503API_KEY_NOT_CONFIGUREDLe serveur n'a pas de PUBLISH_API_KEY, les écritures sont désactivées.