AIVIS

AIVIS pour les développeurs

API REST v1 et serveur MCP pour intégrer les analyses de visibilité IA dans vos scripts, tableaux de bord ou assistants IA. Disponibles sur les offres Business et Agency.

Authentification

Chaque requête doit être authentifiée avec une clé API dans l'en-tête Authorization: Bearer aivis_live_.... La clé donne accès au niveau de l'organisation (peut lire/lancer des analyses sur n'importe quel site de l'organisation).

Créez votre première clé API depuis le tableau de bord

API REST v1

POST /api/v1/scan

Lance une analyse (ou la récupère depuis le cache de 7 jours si elle est récente). Même moteur que l'analyse publique gratuite, avec une limite de 30 requêtes par 10 minutes et par clé.

curl -X POST https://aivis.dev/api/v1/scan \
  -H "Authorization: Bearer aivis_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'
{
  "domain": "example.com",
  "score": 82,
  "letter": "B",
  "cached": false
}

GET /api/v1/report/{domain}

Lit le dernier rapport enregistré pour un domaine, sans lancer de nouvelle analyse. Répond 404 si le domaine n'a jamais été analysé.

curl https://aivis.dev/api/v1/report/example.com \
  -H "Authorization: Bearer aivis_live_..."
{
  "domain": "example.com",
  "score": 82,
  "letter": "B",
  "pagesCrawled": 12,
  "crawledAt": "2026-07-04T10:00:00.000Z",
  "sector": "saas",
  "checks": [
    { "id": "robots-ai-bots", "label": "AI bot access", "status": "pass", "score": 100, "evidence": ["..."], "fixHint": null }
  ]
}

GET /api/v1/badge/{domain}

Badge SVG avec le score le plus récent — aucune authentification requise (identique à /api/badge, uniquement sous l'espace de noms v1 pour la cohérence de la documentation : une image intégrée via <img> ne peut pas porter d'en-tête d'authentification).

<a href="https://aivis.dev/report/example.com">
  <img src="https://aivis.dev/api/v1/badge/example.com" alt="AIVIS AI Visibility Score" />
</a>

Tous les endpoints répondent 401 avec une clé absente/invalide et 403 si l'organisation n'est pas sur une offre Business ou Agency.

Serveur MCP

AIVIS est également disponible en tant que serveur MCP (Model Context Protocol) : un assistant IA compatible peut lancer des analyses et lire des rapports directement, sans passer par un navigateur. Endpoint : POST https://aivis.dev/api/mcp, JSON-RPC 2.0, même authentification Bearer que l'API REST.

Exemple de configuration pour un client MCP prenant en charge des en-têtes personnalisés (par exemple Claude Desktop) :

{
  "mcpServers": {
    "aivis": {
      "url": "https://aivis.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer aivis_live_..."
      }
    }
  }
}

Nécessite une offre Business ou Agency

L'API publique et le serveur MCP sont inclus dans les offres Business (49€/mois) et Agency (99€/mois).

Voir les offres