> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils de performance

> Outils pour analyser la performance GEO de votre marque et ses indicateurs par Topic.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de référence des filtres globaux. Ces paramètres communs s’ajoutent aux paramètres propres à chaque outil présentés ci-dessous.
</Note>

## get\_brand\_performance

Obtient le taux de mention, le taux de citation, la part de voix et le sentiment d’une marque sur un périmètre d’analyse défini.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"`, ou `"custom"` avec des dates ; 30 jours par défaut |
| `startDate` | string | Non | Date de début incluse (`YYYY-MM-DD`) ; à fournir avec `endDate` |
| `endDate` | string | Non | Date de fin incluse (`YYYY-MM-DD`) ; à fournir avec `startDate` |
| `provider` | string | Non | Filtre par fournisseur IA (par exemple « openai », « anthropic », « perplexity ») |
| `providers` | string\[] | Non | Identifiants de fournisseurs ou de modèles IA ; valeurs combinées par OU |
| `topic` / `topicId` | string | Non | Alias pour un seul Topic, avec un UUID renvoyé par `list_topics` |
| `topicIds` | string\[] | Non | UUID de Topics ; valeurs combinées par OU |
| `tag` / `tagId` | string | Non | Alias pour un seul Tag, avec un UUID renvoyé par `list_tags` |
| `tagIds` | string\[] | Non | UUID de Tags ; valeurs combinées par OU |
| `funnelStages` | string\[] | Non | Parmi `TOFU`, `MOFU`, `BOFU` et `POST_PURCHASE` ; valeurs combinées par OU |
| `competitorDomainId` | string | Non | UUID d’un domaine concurrent SELF renvoyé par `get_competitors` |

<Note>
  Sans paramètre de date, les 30 derniers jours sont analysés. Les dates personnalisées `startDate` et `endDate` priment sur `period`. Le Topic et le Tag se combinent avec l’une ou l’autre fenêtre et avec un filtre de fournisseur.
</Note>

### Résultat

| Champ | Description |
| - | - |
| `brand` | Identifiant, nom et domaine de la marque |
| `appliedFilters` | Fenêtre d’analyse et filtres de taxonomie effectivement utilisés pour le résultat |
| `period` | Dates de début et de fin analysées, incluses |
| `scores.mentionRate` | Réponses mentionnant SELF divisées par les réponses mentionnant au moins une marque SELF ou DIRECT |
| `scores.sourceRate` | Réponses citant SELF divisées par les réponses citant au moins une marque SELF ou DIRECT |
| `scores.shareOfVoice` | Mentions de SELF divisées par l’ensemble des mentions SELF et DIRECT |
| `scores.sentiment` | Score de sentiment moyen de SELF (0 à 100) |
| `scoreDetails` | Numérateur et dénominateur du taux de mention, du taux de citation et de la part de voix |
| `methodology` | Nombre de prompts, de fournisseurs et de réponses dans le périmètre filtré |

### Exemple de sortie

```markdown theme={null}
## GEO Performance: Acme Corp

Period: 2026-07-24 to 2026-08-23

### Key metrics
- Mention Rate: 45% (72 / 160 relevant responses)
- Source Rate: 28% (42 / 150 citable responses)
- Share of Voice: 38% (152 / 400 brand mentions)
- Sentiment: 78/100

### Methodology
- 156 monitored prompts
- 8 AI providers
- 2,340 total responses analyzed
```

### Exemples de prompts

```text theme={null}
Quel est mon score GEO ?
```

```text theme={null}
Montre-moi la performance des 30 derniers jours
```

```text theme={null}
Quelle est la performance de ma marque sur ChatGPT ?
```

```text theme={null}
Compare ma performance de ce mois-ci avec celle du mois dernier
```

```text theme={null}
Montre ma part de voix pour ce Tag sur les 30 derniers jours
```

### Scope OAuth

Requis : `read:visibility`

***

## get\_visibility\_trend

Obtient la visibilité IA de la marque sous forme de série temporelle. Renvoie des points quotidiens (ou hebdomadaires) pour suivre l’évolution du taux de mention, du sentiment et de la position, ainsi qu’une direction de tendance calculée (hausse, baisse ou stable).

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `groupBy` | string | Non | Regroupe les points par `day` (par défaut) ou `week` |

### Résultat

| Champ | Description |
| - | - |
| `period` / `periodLabel` | La fenêtre analysée (par exemple `30d`, « Last 30 days ») |
| `groupBy` | Regroupement des points par jour ou par semaine |
| `dataPoints[]` | Par point : `date`, `totalAnswers`, `brandMentions`, `sourceCitations`, `visibilityRate` (%), `avgSentiment` (0 à 100, null en l’absence de données), `avgPosition` (null si la marque n’est pas mentionnée) |
| `trend` | `direction` (up/down/stable), `change` et une courte `description` (première moitié de la période comparée à la seconde) |
| `summary` | `totalAnswers`, `totalBrandMentions`, `avgVisibility` (%) |

### Exemples de prompts

```text theme={null}
Comment ma visibilité a-t-elle évolué au cours du dernier mois ?
```

```text theme={null}
Montre-moi ma tendance de visibilité par semaine
```

### Scope OAuth

Requis : `read:visibility`

***

## get\_sentiment\_trend

Obtient le sentiment envers la marque sous forme de série temporelle quotidienne, avec la position moyenne et le taux de mention de chaque jour. Utilisez-le pour repérer quand la perception de la marque par l’IA change.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |

### Résultat

| Champ | Description |
| - | - |
| `period` / `periodLabel` | La fenêtre analysée |
| `dataPoints[]` | Par jour : `date`, `avgSentiment` (0 à 100, null en l’absence de données), `avgPosition` (null si la marque n’est pas mentionnée), `totalAnswers`, `brandMentionRate` |
| `summary` | `avgSentiment` (0 à 100), `totalAnswers`, `brandMentionRate` sur l’ensemble de la période |

### Exemples de prompts

```text theme={null}
Le sentiment envers ma marque s’améliore-t-il ou se dégrade-t-il ?
```

```text theme={null}
Montre-moi mon sentiment jour par jour sur les 90 derniers jours
```

### Scope OAuth

Requis : `read:topics`

***

## get\_provider\_breakdown

Obtient les indicateurs de visibilité ventilés par fournisseur IA (ChatGPT, Claude, Perplexity, Gemini, Copilot, Grok, etc.). Utilisez-le pour voir sur quels moteurs la marque gagne ou perd du terrain.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |

### Résultat

| Champ | Description |
| - | - |
| `period` / `periodLabel` | La fenêtre analysée |
| `providers[]` | Par fournisseur : `provider`, `totalAnswers`, `brandMentions`, `visibilityRate` (%), `avgSentiment` (0 à 100, null en l’absence de données), `avgPosition` (null si la marque n’est pas mentionnée) |
| `summary` | `totalProviders`, `totalAnswers`, `totalBrandMentions`, `overallVisibility` (%) |

### Exemples de prompts

```text theme={null}
Quel fournisseur IA mentionne le plus ma marque ?
```

```text theme={null}
Compare ma visibilité sur ChatGPT, Claude et Perplexity
```

### Scope OAuth

Requis : `read:visibility`

***

## get\_keyword\_triggers

Identifie les mots-clés et les types de questions qui déclenchent le plus souvent une mention de la marque dans les réponses IA. Renvoie un taux de déclenchement (part des réponses contenant ce mot-clé qui mentionnent la marque) par mot-clé et par type de question.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `limit` | number | Non | Nombre maximal de mots-clés renvoyés (par défaut : 10) |

### Résultat

| Champ | Description |
| - | - |
| `period` / `periodLabel` | La fenêtre analysée |
| `keywords[]` | Par mot-clé : `keyword`, `totalAnswers`, `brandMentions`, `triggerRate` (%) |
| `questionTypes[]` | Par type de question : `type`, `totalAnswers`, `brandMentions`, `triggerRate` (%) |
| `insights` | `bestPerforming`, `needsImprovement`, `totalKeywords`, `avgTriggerRate` |

### Exemples de prompts

```text theme={null}
Quels mots-clés déclenchent le plus souvent ma marque dans les réponses IA ?
```

```text theme={null}
Sur quels types de questions suis-je le plus faible ?
```

### Scope OAuth

Requis : `read:visibility`

***

## get\_topics

Obtient la performance ventilée par Topic ou mot-clé pour repérer les points forts et les opportunités.

<Note>
  Cette vue de performance renvoie les Topics ayant des réponses sur la période sélectionnée. Utilisez `list_topics` pour le catalogue complet des Topics configurés, y compris ceux sans réponse récente.
</Note>

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `startDate` | string | Non | Date de début (YYYY-MM-DD) |
| `endDate` | string | Non | Date de fin (YYYY-MM-DD) |
| `limit` | number | Non | Nombre maximal de Topics renvoyés (par défaut : 20) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant du Topic ou du mot-clé |
| `text` | string | Nom du Topic |
| `score` | number | Score global du Topic (0 à 100) |
| `mentionRate` | number | Part des réponses qui mentionnent la marque, en % |
| `sourceRate` | number | Part des réponses qui citent la marque, en % |
| `shareOfVoice` | number | Marque face aux concurrents sur ce Topic |
| `promptsCount` | number | Nombre de prompts de ce Topic |

### Exemple de sortie

```markdown theme={null}
## Performance by topic

| Topic | Score | Mention Rate | Source Rate | Share of Voice | Prompts |
|-------|-------|--------------|-------------|----------------|---------|
| Project Management | 78 | 52% | 34% | 42% | 45 |
| Team Collaboration | 71 | 45% | 28% | 38% | 32 |
| Workflow Automation | 65 | 38% | 22% | 31% | 28 |
| Time Tracking | 58 | 32% | 18% | 25% | 21 |
```

### Exemples de prompts

```text theme={null}
Quels Topics fonctionnent le mieux pour ma marque ?
```

```text theme={null}
Où suis-je le plus faible en visibilité IA ?
```

```text theme={null}
Montre-moi la performance par mot-clé
```

### Scope OAuth

Requis : `read:topics`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.