Vous souhaitez automatiser vos audits de visibilité IA, intégrer les résultats dans votre dashboard interne ou connecter AILabsAudit à vos outils existants ? L'API REST v1 est faite pour ça. Ce guide pratique vous accompagne de la première requête aux patterns d'intégration avancés.
Pourquoi intégrer l'API REST d'AILabsAudit ?
L'interface web d'AILabsAudit est idéale pour un usage manuel, mais elle a ses limites quand vous gérez des dizaines de clients ou que vous devez automatiser des workflows. L'API REST ouvre des possibilités que l'interface ne peut pas offrir :
- Automatisation complète : Lancez des audits programmés via cron jobs ou workflows CI/CD
- Intégration dashboard : Affichez les scores de visibilité IA directement dans votre outil de reporting
- Alertes personnalisées : Détectez les baisses de visibilité et notifiez automatiquement vos équipes
- Rapports sur mesure : Combinez les données AILabsAudit avec vos propres métriques pour des rapports enrichis
- Synchronisation CRM : Liez les données d'audit à vos fiches clients dans votre CRM
Ce que vous pouvez faire avec l'API
Gestion des clients
Accédez à l'ensemble de votre portefeuille clients via l'endpoint /api/v1/clients. Récupérez les détails, contacts, concurrents et la vue 360° complète de chaque client.
Audits et résultats
Lancez de nouveaux audits programmatiquement avec POST /api/v1/audits/launch, suivez leur progression et récupérez les résultats détaillés : scores de visibilité, performances par modèle IA, tendances et comparaisons.
Rapports PDF
Téléchargez les rapports PDF premium via GET /api/v1/reports/{id}/download pour les intégrer dans vos workflows de livraison client automatisés.
Analytics et portfolio
Accédez aux analytics avancées : vue d'ensemble du portfolio, classement de visibilité, distribution des scores. Parfait pour construire des dashboards de suivi multi-clients.
Quick start en 3 étapes
Étape 1 : Créer votre clé API
Rendez-vous dans Compte → API & Integrations et créez une nouvelle clé. Elle commencera par aila_.
Étape 2 : Tester la connexion
Première requête
curl -H "X-Api-Key: aila_votre_cle" https://ailabsaudit.com/api/v1/clientsSi vous voyez la liste de vos clients en JSON, tout fonctionne !
Étape 3 : Explorer les endpoints
Consultez le tutoriel API REST complet pour découvrir les 8 groupes d'endpoints, ou explorez directement la documentation Swagger.
Patterns d'intégration courants
Audits planifiés automatiques
Le cas d'usage le plus populaire : un cron job qui lance un audit pour chaque client à intervalle régulier (hebdomadaire ou mensuel), récupère les résultats et les stocke dans votre base de données.
# Exemple : audit mensuel pour tous les clients
import requests
API_KEY = "aila_votre_cle"
BASE = "https://ailabsaudit.com/api/v1"
headers = {"X-Api-Key": API_KEY}
clients = requests.get(f"{BASE}/clients", headers=headers).json()
for client in clients["data"]:
requests.post(f"{BASE}/audits/launch",
headers=headers,
json={"client_id": client["id"]})
Dashboard embedding
Intégrez les scores de visibilité dans votre propre dashboard en appelant l'endpoint analytics :
scores = requests.get(f"{BASE}/analytics/leaderboard", headers=headers).json()
# Affichez dans votre interfaceAlertes de baisse de visibilité
Comparez les scores entre deux audits successifs et envoyez une alerte (email, Slack) si un client perd plus de 10 points :
audit_history = requests.get(
f"{BASE}/audits?client_id=42&per_page=2",
headers=headers
).json()
# Comparez les scores et alertez si besoinBonnes pratiques
Respectez le rate limiting
L'API autorise 60 requêtes par minute par clé. Espacez vos appels et implémentez un backoff exponentiel pour les erreurs 429. Consultez les headers X-RateLimit-* pour monitorer votre consommation.
Cachez les réponses
Les données d'audit ne changent pas fréquemment. Mettez en cache les réponses (Redis, fichier local) pendant 1 à 24h pour réduire les appels API et améliorer les performances de votre application.
Gérez les erreurs proprement
L'API retourne des codes HTTP standards et des messages d'erreur en JSON. Gérez au minimum les cas 401 (clé invalide), 429 (rate limit) et 500 (erreur serveur).
Sécurisez votre clé
Stockez votre clé API dans une variable d'environnement, jamais dans votre code source. Utilisez des clés différentes par environnement (dev/production) et révoquez immédiatement une clé compromise.
Ressources utiles
Pour aller plus loin
Explorez ces ressources pour maîtriser l'API REST :
- Tutoriel API REST complet — Guide pas-à-pas avec exemples de code
- Documentation Swagger — Référence interactive de tous les endpoints
- Glossaire : API REST — Définition et concepts clés
- Guide MCP — Connectez votre IA directement à AILabsAudit
FAQ
Quel abonnement faut-il pour accéder à l'API REST ?
L'API REST est disponible avec les plans Enterprise et Partenaire. Les plans gratuits et standard n'incluent pas l'accès API. Demandez un accès partenaire pour commencer.
L'API REST utilise-t-elle les mêmes clés que le MCP ?
Oui, c'est la même clé API (format aila_...). Vous pouvez l'utiliser à la fois pour les appels REST et les connexions MCP. Créez-la depuis API & Integrations.
Quelle est la limite de requêtes ?
60 requêtes par minute par clé API. Les headers de réponse (X-RateLimit-Remaining) vous indiquent votre consommation en temps réel.
Puis-je lancer des audits via l'API ?
Oui, l'endpoint POST /api/v1/audits/launch permet de lancer des audits programmatiquement. Vous pouvez estimer le coût en crédits au préalable et suivre la progression de l'audit.
Existe-t-il un SDK officiel ?
Pas encore, mais le tutoriel API REST fournit des exemples complets en Python, JavaScript et PHP que vous pouvez utiliser comme base. Un SDK officiel est en cours de développement.
Conclusion
L'API REST d'AILabsAudit est la clé pour passer de l'utilisation manuelle à l'automatisation complète de vos audits de visibilité IA. Que vous souhaitiez planifier des audits récurrents, intégrer les scores dans votre dashboard ou créer des alertes personnalisées, l'API vous donne les outils pour le faire.
Prêt à automatiser ?
