Gardez un œil sur votre marque dans les réponses IA

Les moniteurs envoient votre ensemble de prompts aux moteurs IA de votre choix selon un calendrier et notent chaque réponse selon les mentions et citations de votre marque.

Ce que vous obtenez

• Taux de mention : la part des réponses qui nomment votre marque, par moteur et par prompt.
• Taux de citation : la part des réponses qui citent l’un de vos domaines.
• Un tableau prompts par moteurs qui montre où votre marque apparaît, avec la réponse complète derrière chaque cellule.
• Une alerte par e-mail quand le taux de mention passe sous le seuil que vous fixez.

Fonctionnement

Un moniteur est un ensemble de prompts nommé pour un marché : les prompts, les moteurs à interroger, les noms qui désignent votre marque, vos domaines, un pays et une fréquence, de toutes les heures à toutes les semaines. Chaque exécution envoie chaque prompt à chaque moteur et note chaque réponse une fois : si elle nomme votre marque et où, si elle cite vos domaines et quels concurrents apparaissent à vos côtés.

Chaque chiffre renvoie aux réponses qui le composent : quand un taux bouge, vous ouvrez directement les réponses qui ont changé et voyez ce que les moteurs ont dit.

Cas d’usage

• Suivez semaine après semaine votre place dans les réponses IA aux questions de vos acheteurs.
• Repérez les prompts et les moteurs où des concurrents passent devant vous.
• Observez l’évolution des taux de mention et de citation après la publication de nouveaux contenus.

Pour commencer

Créez un moniteur depuis Moniteurs dans le tableau de bord ou avec POST /v1/monitors. Un prompt qui contient le nom de votre marque compte toujours comme une mention : rédigez donc vos prompts avec les mots d’un acheteur.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

curl -X POST https://api.querying.ai/v1/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes, US",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "best running shoes for flat feet",
      "most comfortable running shoes for beginners"
    ],
    "aliases": ["Acme", "Acme Running"],
    "domains": ["acme.com"],
    "country": "US",
    "intervalHours": 24,
    "alertBelowPct": 30
  }'

Champs de la requête

namestringObligatoire

Un nom pour le moniteur.

enginesarrayObligatoire

Moteurs interrogés, jusqu’à 12, comme CHATGPT, GEMINI, PERPLEXITY et GOOGLE.

promptsarrayObligatoire

De 1 à 100 questions posées à chaque exécution, rédigées comme un acheteur les pose.

aliasesarrayObligatoire

Les noms et graphies de votre marque, jusqu’à 20. Une réponse qui en emploie un compte comme mention.

domainsarray

Vos sites, jusqu’à 20. Une réponse qui en cite un compte comme citation.

competitorsarray

Marques à comparer, chacune avec name et aliases. La lecture hebdomadaire ajoute celles que citent les réponses.

countrystring

Le marché pour lequel les moteurs répondent. Par défaut US.

intervalHoursinteger

Heures entre deux exécutions, de 1 à 168 : 1 toutes les heures, 24 chaque jour, 168 chaque semaine.

alertBelowPctinteger

Alerte par e-mail quand votre taux de mention passe sous ce pourcentage, de 1 à 100.

Réponse

La réponse, raccourcie pour la lecture.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes, US",
      "mode": "BRAND",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 24,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}

data.monitor.idstring

L’ID du moniteur. Il sert à lire le rapport, les résultats notés et chaque réponse.

data.monitor.nextRunAtstring

L’heure de la prochaine exécution. La première démarre dès la création du moniteur, puis une exécution a lieu toutes les intervalHours.

Lire les résultats

Chaque exécution ajoute une ligne par prompt et par moteur. GET /v1/monitors/{id}/results renvoie les lignes de la plus récente à la plus ancienne, et nextCursor repart en cursor pour la page suivante. Ces lignes viennent du rapport public sur les chaussures de running, raccourcies pour la lecture.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)"
    },
    "truncated": true,
    "nextCursor": "2026-09-30T11:51:14.888000Z~7fc7c713-a2f2-41f8-befd-c04b830d69e5",
    "results": [
      {
        "taskId": "bc96f867-7349-4987-b498-f0080c149f3d",
        "engine": "PERPLEXITY",
        "prompt": "What are the best waterproof running shoes to choose?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:33.415000Z",
        "competitorHits": ["HOKA", "On", "Brooks", "Salomon"]
      },
      {
        "taskId": "6b8222fd-01bd-44d7-9a0b-8d0aecb32e19",
        "engine": "PERPLEXITY",
        "prompt": "What are the best running shoes for kids?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:14.888000Z",
        "competitorHits": ["HOKA", "On", "ASICS", "Nike", "New Balance"]
      }
    ]
  }
}

mentionedboolean

true quand la réponse nomme votre marque par l’un de ses aliases.

citedboolean

true quand la réponse cite une page de l’un de vos domains.

positioninteger

Position, en caractères, de la première mention de votre marque, une mesure de visibilité. null quand la réponse laisse votre marque de côté.

competitorHitsarray

Les concurrents que cite la réponse.

taskIdstring

La réponse derrière la ligne. GET /v1/monitors/{id}/answers/{taskId} la renvoie en entier, avec ses sources.

Tarif

Une exécution coûte le nombre de prompts multiplié par les crédits de chaque moteur. Par exemple, 12 prompts sur ChatGPT (2 crédits) et Gemini (1 crédit) coûtent 36 crédits par exécution, soit environ 1 080 crédits par mois en rythme quotidien.