Mentionable
Essai gratuit
Toutes les fonctionnalités

API de visibilité IA : vos données Mentionable dans vos propres outils

Une API REST en lecture seule pour vos données de visibilité IA : projets, métriques quotidiennes, chaque réponse des IA et part de voix face à vos concurrents, en JSON ou en CSV. Clés API restreintes par projet, incluses dans toutes les offres.

Démarrer l'essai gratuit

GET/api/v1/projects/…/metrics

{
  "data": [
    {
      "date": "2026-09-29",
      "llm": "chatgpt",
      "mentionRate": 42.5,
      "citationRate": 18.2,
      "avgPosition": 2.4
    },
    {
      "date": "2026-09-29",
      "llm": "perplexity",
      "mentionRate": 51.3,
      "citationRate": 27.9,
      "avgPosition": 1.9
    }
  ]
}

Points clés

  • L'API REST de Mentionable expose quatre points d'accès en lecture seule : vos projets, les métriques quotidiennes, chaque réponse des IA, et la part de voix face à vos concurrents confirmés.
  • Chaque point d'accès répond en JSON ou en CSV, avec des filtres sur les dates (jusqu'à un an par appel), les IA et la catégorie de questions.
  • L'accès passe par une clé API créée dans les paramètres, affichée une seule fois, révocable en un clic, et restreignable à une liste de projets.
  • L'API, le serveur MCP et le connecteur Looker Studio partagent les mêmes clés et la même limite : 100 requêtes par minute et par clé.
  • Incluse dans toutes les offres, marques et agences, pendant l'essai gratuit de 7 jours aussi. Lire les données ne coûte rien.

Votre équipe data construit le reporting marketing mensuel dans un entrepôt de données. Votre agence envoie à ses clients un deck généré depuis un tableur. Votre directeur général ne regarde qu'un seul tableau de bord interne. La visibilité IA vit dans Mentionable, et tant que quelqu'un ne recopie pas les chiffres à la main, elle ne vit nulle part ailleurs.

L'API Mentionable supprime la recopie. Chaque chiffre du dashboard est disponible en lignes que vos propres outils savent lire, en JSON ou en CSV, au rythme que vous choisissez.

Que renvoie l'API Mentionable ?

L'API Mentionable est une API REST en lecture seule sous /api/v1, avec quatre points d'accès, un par question que vous posez à vos données.

Quels projets puis-je lire ? GET /api/v1/projects liste les projets accessibles à votre clé : nom, site, marque, date de création.

Comment évolue ma visibilité ? GET /api/v1/projects/{id}/metrics renvoie une ligne par jour, par IA et par catégorie de questions : le nombre de réponses, les mentions, les citations de votre site, le taux de mention, le taux de citation, la position moyenne, et la répartition entre sentiment positif, neutre et négatif.

Qu'a vraiment répondu chaque IA ? GET /api/v1/projects/{id}/results renvoie une ligne par réponse d'IA : la question, le moteur, la date, la présence de votre marque, sa position, le sentiment, et le nombre de concurrents cités à côté de vous. Les résultats sont paginés, du plus récent au plus ancien, jusqu'à 1 000 lignes par page.

Qui prend la place à ma place ? GET /api/v1/projects/{id}/competitors renvoie une ligne par jour, par IA et par marque : la vôtre et chaque concurrent que vous avez confirmé, avec les mentions, la position moyenne et la part de voix.

Les définitions sont celles du dashboard. Un taux de mention dans votre entrepôt est le même que celui que votre équipe lit dans Mentionable : personne ne débat de quel chiffre est le bon.

À quoi ressemble un appel ?

Une URL, une clé, des filtres optionnels :

curl -H "Authorization: Bearer mnt_sk_..." \
  "https://mentionable.ai/api/v1/projects/{id}/metrics?from=2026-09-01&to=2026-09-30&llm=chatgpt,perplexity"

Tous les points d'accès acceptent les mêmes filtres :

Paramètre Ce qu'il fait
from, to Période, jusqu'à 366 jours par appel. Les 30 derniers jours par défaut.
llm Une ou plusieurs IA, séparées par des virgules.
categoryId Une seule catégorie de questions.
format json (par défaut) ou csv.
limit, cursor Taille de page et page suivante, sur les résultats.

Les lignes sont plates exprès. Les compteurs comme mentions et results s'additionnent sur n'importe quelle dimension, par mois, par IA, par catégorie, et les taux se recalculent à partir d'eux : un total mensuel correspond au dashboard au lieu de faire la moyenne de pourcentages quotidiens.

Les erreurs reviennent en JSON, avec un code machine et un message lisible : clé absente, offre requise, projet hors périmètre, requête invalide.

Où est la documentation ?

Sur mentionable.ai/api/v1/docs, une référence interactive où vous collez une clé et essayez chaque point d'accès. Le même contrat est publié en fichier OpenAPI sur /api/v1/openapi.json, que la plupart des clients HTTP, générateurs de code et outils no-code importent directement.

Comment les clés API sont-elles sécurisées ?

Les clés se créent dans Paramètres, MCP, par un propriétaire ou un administrateur de l'espace. La clé complète s'affiche une seule fois, à sa création. Ensuite, la liste n'en montre que les premiers caractères, son périmètre, sa dernière utilisation et son statut : active, expirée ou révoquée.

Une clé peut être restreinte à une liste de projets. Elle ne liste et ne lit alors que ces projets, et tout appel sur un autre projet est refusé. Une clé ne lit jamais plus que la personne qui l'a créée : si un membre n'a accès qu'à deux projets, ses clés n'atteignent pas le troisième.

L'API ne fait que lire. Aucun point d'accès ne crée, ne modifie ni ne supprime quoi que ce soit : une clé qui fuite ne peut pas toucher à votre suivi. Révoquez-la en un clic et l'appel suivant est refusé.

Qui utilise l'API Mentionable ?

Les marques qui ont une équipe data. La visibilité IA rejoint le reste de vos données marketing dans votre entrepôt ou votre outil de BI, à côté du trafic, du paid et du CRM. La revue marketing de la semaine l'affiche sans que personne n'exporte un fichier.

Les agences. Récupérez les métriques de chaque client dans le reporting que vous vendez déjà, et donnez à un client une clé restreinte à son projet si son équipe veut les données brutes.

Tous ceux qui ont un tableur. format=csv et une clé dans l'URL suffisent pour que Google Sheets ou Excel lise un tableau à jour.

Si vous vivez dans Looker Studio, le connecteur Looker Studio lit les mêmes données sans code. Si vous préférez poser vos questions en langage naturel, le serveur MCP permet à Claude, ChatGPT ou Cursor de lire vos projets avec la même clé.

Quelles offres incluent l'API ?

Toutes les offres Mentionable, marques et agences, incluent l'API, le serveur MCP et le connecteur Looker Studio. L'API fonctionne aussi pendant l'essai gratuit de 7 jours : vous branchez votre reporting avant de vous abonner.

Lire les données par l'API ne consomme rien de votre offre. La seule limite est technique : 100 requêtes par minute et par clé, partagées avec le serveur MCP. Au-delà, l'API répond 429 avec un en-tête Retry-After.

Curieux de savoir si l'IA mentionne votre marque ?

Lancez un scan gratuit et voyez où vous en êtes sur ChatGPT.

Scan IA gratuit

Continuer la lecture

Questions fréquentes

Mentionable a-t-il une API ?

Oui. Mentionable propose une API REST en lecture seule sous /api/v1. Elle renvoie vos projets, vos métriques quotidiennes de visibilité IA, chaque réponse des IA collectée sur vos questions suivies, et la part de voix face à vos concurrents confirmés, en JSON ou en CSV. Une référence interactive et un fichier OpenAPI sont publiés sur /api/v1/docs et /api/v1/openapi.json.

Quelles données puis-je récupérer avec l'API Mentionable ?

Quatre jeux de données. Projets liste les projets que votre clé peut lire. Métriques donne une ligne par jour, par IA et par catégorie de questions, avec réponses, mentions, citations, taux de mention, taux de citation, position moyenne et sentiment. Résultats donne une ligne par réponse d'IA avec la question, le moteur, la présence de votre marque, sa position, le sentiment et le nombre de concurrents cités. Concurrents donne les mentions, la position moyenne et la part de voix de votre marque et de chaque concurrent confirmé.

L'API Mentionable peut-elle renvoyer du CSV ?

Oui. Ajoutez format=csv à n'importe quel point d'accès et la réponse arrive en fichier CSV au lieu de JSON, avec les mêmes lignes. C'est ce qu'attendent les tableurs et la plupart des outils de BI : un Google Sheet ou un import Excel lit l'URL directement.

Comment s'authentifier sur l'API Mentionable ?

Avec une clé API créée dans Paramètres, MCP. Envoyez-la dans un en-tête Authorization en Bearer. Les outils qui ne savent pas poser d'en-tête, comme Google Sheets ou Looker Studio, peuvent la passer en paramètre key dans l'URL. La clé s'affiche une seule fois à sa création, peut être restreinte à certains projets et révoquée à tout moment.

Puis-je donner à un client une clé API qui ne voit que son projet ?

Oui. À la création d'une clé, vous pouvez la restreindre à une liste de projets. Une clé restreinte ne liste et ne lit que ces projets, et tout appel sur un autre projet est refusé. Une clé ne voit jamais plus que la personne qui l'a créée.

Quelles offres Mentionable incluent l'API ?

Toutes les offres, marques et agences, incluent l'API, avec le serveur MCP et le connecteur Looker Studio, et elle fonctionne pendant l'essai gratuit de 7 jours. Lire les données par l'API ne consomme rien de votre offre. Les clés cessent de fonctionner si l'abonnement est résilié ou impayé.

L'API Mentionable a-t-elle une limite de requêtes ?

Oui, 100 requêtes par minute et par clé API, partagées avec le serveur MCP. Au-delà, l'API répond 429 avec un en-tête Retry-After qui indique à votre script combien de secondes attendre. Une année de métriques quotidiennes tient en un seul appel : un reporting normal reste très loin de la limite.

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.

Démarrer l'essai gratuit