API

L’API renvoie vos propres données, et rien d’autre : les fiches de votre compte, leurs performances, les avis laissés dessus et les concurrents que vous suivez. C’est une API en lecture seule. Tout ce qui modifie des données se fait dans le tableau de bord, de sorte qu’une clé divulguée permet de copier vos chiffres, mais pas de modifier votre fiche, ni de dépenser de l’argent, ni de toucher au compte de quelqu’un d’autre.

Elle est gratuite, comme tout le reste ici. Chaque compte peut émettre une clé depuis le tableau de bord.

La clé

Créez la clé dans votre tableau de bord, sur l’onglet Outils de référencement, dans le bloc intitulé Exports et accès API. Elle se présente sous la forme sl_ suivi de 48 caractères hexadécimaux, et le tableau de bord affiche sa date d’émission.

Une clé par compte. Un clic sur Nouvelle clé en émet une nouvelle, et la précédente cesse de fonctionner à cet instant. Il n’y a ni délai de grâce ni seconde clé en parallèle : changez-la donc quand vous êtes prêt à mettre à jour ce qui l’utilise.

Renouvelez-la si elle s’est retrouvée dans un dépôt public, un document partagé, un navigateur ou un service que vous n’utilisez plus. Le renouvellement prend un clic et ne coûte rien.

Révoquez-la en la supprimant dans le même bloc. Le compte continue de fonctionner, seul l’accès à l’API s’arrête.

Traitez la clé comme un mot de passe. Gardez-la sur un serveur, dans une variable d’environnement ou un coffre à secrets, jamais dans du code front-end : tout ce qui se trouve dans un navigateur est lisible par quiconque ouvre la page. Nous n’envoyons volontairement pas d’en-têtes CORS sur ces points d’accès, si bien qu’une page de navigateur hébergée sur un autre domaine ne peut pas les appeler avec votre clé.

L’appeler

Chaque requête transporte la clé dans l’en-tête Authorization. L’adresse de base est https://saasledge.com/api/v1.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/me

Les réponses sont en JSON avec "ok": true. Les erreurs gardent la même forme avec "ok": false et un court code lisible par une machine.

La limite est de 120 requêtes par minute et par clé. C’est généreux pour un export nocturne, et serré pour une boucle qui a oublié de s’arrêter.

GET /api/v1/me

Le compte associé à la clé et les limites sur lesquelles tout le reste est compté. Servez-vous-en comme test de bon fonctionnement.

{
  "ok": true,
  "account": {
    "email": "[email protected]",
    "products": 3,
    "since": "2026-08-13"
  },
  "key": { "issued_at": "2026-08-14 09:12:33" },
  "limits": {
    "products": 25,
    "watches": 25
  },
  "rate": { "limit": 120, "per": "minute" }
}

GET /api/v1/products

Vos fiches avec tout ce qui y est publié : état, catégorie, modèle tarifaire, formules, nombre de captures d’écran, nombre d’avis et note moyenne. Chaque élément contient url_on_saasledge, l’adresse publique de la fiche.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/products

GET /api/v1/stats

Les vues de vos fiches et les clics vers votre site web, regroupés par jour.

Les jours sans événement ne sont pas renvoyés. Les totaux sont calculés pour vous dans totals, y compris le taux de clic en pourcentage.

curl -H "Authorization: Bearer sl_your_key" \
  "https://saasledge.com/api/v1/stats?days=90&format=csv" -o stats.csv

GET /api/v1/reviews

Les avis publiés sur vos fiches, avec vos réponses et les dates. without_reply compte ceux qui attendent encore une réponse, et c’est le chiffre sur lequel il vaut la peine de déclencher une alerte.

Les adresses e-mail des auteurs d’avis ne sont jamais renvoyées. Elles sont collectées pour que nous puissions vérifier un avis, pas pour qu’on leur écrive.

GET /api/v1/watches

Les concurrents de votre liste de suivi : prix d’entrée actuel et avant le dernier changement, nombre de formules, indicateurs de formule gratuite et d’essai, note, nombre d’avis, et historique des prix sur la période. La même réponse contient mine, le prix d’entrée et le nombre de formules de vos propres fiches en ligne, ce qui permet de comparer avec une requête au lieu de deux.

Ce que l’API ne fera pas

Elle n’affichera pas les données privées d’un autre éditeur, elle n’écrira rien, et elle n’exportera pas l’ensemble du catalogue. La copie en masse du catalogue n’est pas quelque chose que nous vendons, et ce n’est pas ce que la clé ouvre.

Des questions, ou un cas d’usage qui demande un champ que nous ne renvoyons pas encore : écrivez à [email protected] en indiquant ce que vous construisez.