Suivez tout un marché avec les moniteurs de catégorie

Classez les marques que les moteurs d’IA citent sur un marché, avec part de voix et tendance quotidienne.

Ce que vous obtenez

• Un classement de chaque marque suivie que citent les réponses, avec son rang, son taux de mention, sa part de voix et l’évolution par rapport à l’intervalle précédent.
• Les trois marques les plus citées dans chaque sous-domaine et sur chaque moteur, pour voir où chaque marque est forte.
• Les taux quotidiens des cinq marques en tête, et une cellule par prompt et par moteur qui ouvre la réponse correspondante.

Fonctionnement

Un moniteur de marque suit une marque. Un moniteur de catégorie suit un marché : vous nommez la catégorie, regroupez ses prompts par sous-domaine, et chaque exécution pose ces prompts à vos moteurs et note les marques citées dans chaque réponse. Réglez mode sur CATEGORY à la création ; le type reste fixé pendant toute la vie du moniteur.

• category : le marché tel qu’un acheteur le nomme, de 1 à 80 caractères.
• promptTopics : associe chaque prompt à son sous-domaine, avec jusqu’à 30 sous-domaines de 60 caractères au plus. Les prompts hors de cette table couvrent toute la catégorie.
• competitors : jusqu’à 25 marques que vous indiquez. Après la première exécution, une lecture hebdomadaire des réponses ajoute jusqu’à 25 autres marques qu’elles citent.

GET /v1/monitors/{id}/analytics renvoie le rapport. Dans category.brands, la part de voix vaut 100 × les mentions d’une marque ÷ toutes les mentions suivies : les parts d’une même période totalisent 100. Le taux d’une marque se divise par son propre sampleSize, les réponses évaluées pendant sa présence dans la liste : une marque ajoutée aujourd’hui est mesurée à partir d’aujourd’hui.

Cas d’usage

• Découvrez quelles marques dominent votre marché dans les réponses d’IA, et avec quelle avance.
• Voyez les sous-domaines et les moteurs où chaque concurrent domine.
• Présentez chaque semaine la part de voix de la catégorie à vos clients ou à votre direction.

Pour commencer

Dans le tableau de bord, créez un moniteur et choisissez Catégorie comme type de moniteur. Saisissez un sujet et sélectionnez Lancer la recherche : Prompt Research remplit les prompts, leurs sous-domaines et les marques à classer à partir de la demande de recherche pour KR ou US, et vous vérifiez le tout avant de créer le moniteur.

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 market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

Champs de la requête

namestringObligatoire

Un nom pour le moniteur.

modestringObligatoire

BRAND (par défaut) suit votre marque. CATEGORY classe toutes les marques d’un marché.

categorystringObligatoire

Le nom du marché, de 1 à 80 caractères.

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.

promptTopicsobject

Associe chaque prompt à un sous-domaine, comme Kids. Le rapport classe les marques par sous-domaine.

competitorsarray

Les marques classées dès le départ, jusqu’à 25. La lecture hebdomadaire en ajoute jusqu’à 25 depuis 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.

Réponse

La réponse, raccourcie pour la lecture.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "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 le rapport

GET /v1/monitors/{id}/analytics renvoie le rapport des 30 derniers jours. Les chiffres ci-dessous viennent du rapport public sur les chaussures de running, raccourcis pour la lecture.

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

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}

category.brandsarray

Les marques de votre liste et toutes celles que citent les réponses, de la plus citée à la moins citée, avec rank, mentionRate et shareOfVoice.

category.topicsarray

Le même classement pour chaque sous-domaine, dans l’ordre où le moniteur les interroge.

Exporter les réponses

GET /v1/monitors/{id}/results renvoie une ligne par réponse, avec les marques citées dans competitorHits. Ajoutez format=csv pour obtenir un fichier qui s’ouvre dans tout tableur :

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

ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

Tarif

Une exécution coûte autant que celle d’un moniteur de marque : une tâche par prompt et par moteur, au prix en crédits de chaque moteur. L’identification des marques du marché ajoute 100 crédits par mois, répartis sur les exécutions, et la recherche qui remplit le formulaire coûte 12 crédits.