Passer au contenu principal
La commande mint analytics vous donne accès aux analytiques de votre documentation depuis le terminal. Cela est utile pour générer des rapports d’analytique via des scripts, acheminer des données vers d’autres outils et effectuer des vérifications rapides sans ouvrir le tableau de bord.

​
Prérequis

Vous devez vous connecter pour utiliser les commandes d’analytique. Exécutez mint login pour vous authentifier avec votre compte Mintlify. Consultez Prévisualisation locale pour plus de détails sur l’authentification.

​
Consulter les métriques clés

Affichez un résumé des vues, visiteurs, recherches, retours et utilisation de l’assistant : 
mint analytics stats
Utilisez des flags pour filtrer par plage de dates, page ou source de trafic :
  • --from : Date de début au format YYYY-MM-DD. Par défaut, 7 jours en arrière.
  • --to : Date de fin au format YYYY-MM-DD. Par défaut, aujourd’hui.
  • --page : Filtrer sur une page spécifique.
  • --humans : Afficher uniquement le trafic humain.
  • --agents : Afficher uniquement le trafic IA.
Example analytics stats flags
mint analytics stats --from 2025-01-01 --to 2025-01-31
mint analytics stats --page /quickstart
mint analytics stats --humans
mint analytics stats --agents

​
Consulter les analytiques de recherche

Consultez ce que vos utilisateurs recherchent, avec le nombre de résultats et les taux de clics : 
mint analytics search
Utilisez des flags pour filtrer par chaîne de recherche ou par page :
  • --query : Filtrer par sous-chaîne de requête de recherche.
  • --page : Filtrer sur une page spécifique.
Example analytics search flags
mint analytics search --query "authentication"

mint analytics search --page /api-reference

​
Consulter les retours

Consultez les retours soumis par les utilisateurs sur les pages de votre documentation : 
mint analytics feedback
Utilisez des flags pour agréger les retours par page ou filtrer par retours de code :
  • --type : Agréger les retours par page ou extrait de code. Par défaut, page.
  • --page : Filtrer sur une page spécifique.
Example analytics feedback flags
mint analytics feedback --type page
mint analytics feedback --type code

​
Consulter les conversations de l’assistant

Listez les conversations récentes et les catégories de conversations de l’assistant IA : 
mint analytics conversation list
mint analytics conversation buckets list
Chaque liste inclut un ID pour chaque entrée. Transmettez cet ID à la commande view correspondante pour voir les détails complets : 
mint analytics conversation view <conversation-id>
mint analytics conversation buckets view <bucket-id>

​
Choisir un format de sortie

Toutes les commandes d’analytique utilisent par défaut la sortie plain, séparée par des tabulations et adaptée à l’acheminement vers d’autres outils. Utilisez --format pour modifier la sortie : 
mint analytics stats --format table    # Tableau mis en forme avec couleurs
mint analytics stats --format json     # JSON brut
mint analytics stats --format graph    # Graphique à barres horizontal
Utilisez le flag --agent pour obtenir une sortie JSON. La CLI détecte automatiquement les environnements d’agent lorsque la variable d’environnement CLAUDECODE est définie à 1.

​
Définir des valeurs par défaut avec config

Pour éviter de répéter les flags courants, définissez des valeurs par défaut avec mint config. La configuration est enregistrée dans ~/.config/mintlify/config.json. Clés de configuration disponibles :
CléDescription
subdomainSous-domaine par défaut pour les commandes d’analytique.
dateFromDate de début par défaut pour les requêtes d’analytique (YYYY-MM-DD).
dateToDate de fin par défaut pour les requêtes d’analytique (YYYY-MM-DD).
Example configs
mint config set subdomain my-docs
mint config set dateFrom 2025-01-01
Une fois définis, les commandes d’analytique utilisent automatiquement ces valeurs : 
# Utilise le sous-domaine et dateFrom configurés sans flags
mint analytics stats
Pour consulter ou effacer une valeur, exécutez : 
mint config get subdomain
mint config clear subdomain

Sujets connexes

Tutoriel : Créer un assistant de documentation in‑appCréer une documentation développeurDocumentation headless avec un frontend personnalisé