> ## 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 d’insights

> Outils d’insights verticaux : shopping, réseaux sociaux, commerces locaux, requêtes de recherche web et questions de suivi suggérées par les fournisseurs IA.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de filtres de référence et la couverture de chaque outil MCP.
</Note>

## get\_shopping\_insights

Obtient la visibilité e-commerce dans les résultats shopping de l’IA : boutiques qui mentionnent vos produits, produits concurrents, notes et opportunités.

### 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 d’éléments renvoyés (par défaut : 10, maximum : 20) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | Total des produits, boutiques et mentions, note moyenne |
| `topStores[]` | Boutiques avec nombre de produits et de mentions, présence de la marque et des concurrents |
| `topProducts[]` | Produits les plus mentionnés, avec leur note |
| `opportunities[]` | Boutiques où les concurrents apparaissent mais pas la marque (priorité : very-high/high) |

### Scope OAuth

Requis : `read:visibility`

***

## get\_social\_insights

Obtient les citations de réseaux sociaux et de forums dans les réponses IA : Reddit, YouTube, HackerNews, Stack Overflow, etc.

### 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 communautés renvoyées (par défaut : 10, maximum : 20) |

### Résultat

| Champ | Description |
| - | - |
| `summary.totalSocialCitations` | Total des citations de réseaux sociaux et de forums |
| `summary.socialShareOfVoice` | Part des citations sociales dans l’ensemble des citations, en % |
| `platformDistribution[]` | Citations par plateforme (reddit, youtube, etc.) |
| `topCommunities[]` | Domaines sociaux les plus cités, avec leur position moyenne |

### Scope OAuth

Requis : `read:sources`

***

## get\_local\_insights

Obtient la visibilité des commerces locaux dans les réponses IA : établissements mentionnés, catégories, notes et nombre d’avis.

### 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 d’établissements renvoyés (par défaut : 10, maximum : 20) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | Total des mentions, établissements distincts, position moyenne, catégorie principale |
| `categoryDistribution[]` | Mentions par catégorie d’établissement |
| `topBusinesses[]` | Établissements les plus mentionnés, avec note, avis et indicateur de concurrent |

### Scope OAuth

Requis : `read:visibility`

***

## get\_query\_fan\_out

Obtient les requêtes de recherche web détectées dans les réponses IA : variantes de requêtes autour des Topics suivis, avec la visibilité de la marque et la présence des concurrents pour chaque requête.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `promptId` | string | Non | Limite à un prompt suivi issu de `get_prompts` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `limit` | number | Non | Nombre maximal de requêtes renvoyées (par défaut : 20, maximum : 500) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | Total des requêtes, requêtes distinctes, présence moyenne de la marque en % |
| `topQueries[]` | Requêtes les plus fréquentes, avec présence de la marque en %, nombre de concurrents et priorité |

Le résumé est calculé sur l’ensemble du résultat filtré : `avgBrandPresence` reste donc stable d’une page à l’autre.

### Exemples de prompts

```text theme={null}
Montre le Query Fan-Out de ce prompt suivi
```

```text theme={null}
Quelles requêtes dérivées font apparaître des concurrents mais pas ma marque ?
```

### Scope OAuth

Requis : `read:prompts`

***

## get\_follow\_ups

Liste les questions suivantes que les fournisseurs IA ont suggérées après vos réponses suivies, des plus récentes aux plus anciennes. Chaque question de suivi indique son prompt source, le fournisseur et le modèle, sa position dans les suggestions et si vous suivez déjà cette question.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Nombre de jours glissants ou `"all"` ; 30 jours par défaut |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse (`YYYY-MM-DD`), fournie par paire |
| `providers` | string\[] | Non | Identifiants de fournisseurs ou de modèles IA |
| `topicIds` | string\[] | Non | UUID de Topics issus de `list_topics` |
| `tagIds` | string\[] | Non | UUID de Tags issus de `list_tags` |
| `funnelStages` | string\[] | Non | `TOFU`, `MOFU`, `BOFU` ou `POST_PURCHASE` |
| `personaIds` | string\[] | Non | UUID des Personas enregistrées sur la réponse ; `"default"` correspond aux réponses sans Persona |
| `countries` | string\[] | Non | Pays des réponses (codes ISO 3166-1 alpha-2) |
| `limit` | number | Non | Nombre maximal de questions de suivi renvoyées (par défaut : 25, maximum : 100) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

### Résultat

| Champ | Description |
| - | - |
| `pagination` | `total`, `count`, `limit`, `offset` et `hasMore` |
| `followUps[].text` | La question suggérée |
| `followUps[].kind` | `SUGGESTION` (un prompt que le moteur propose tel quel) ou `GUIDED_CONTINUATION` (le message que ChatGPT envoie une fois son formulaire rempli ; les champs apparaissent sous la forme `{placeholders}`) |
| `followUps[].types` | Types d’intention, comme `COMPARISON` ou `HOW_TO` ; vide tant que la question n’est pas classée |
| `followUps[].position` | Position de la suggestion dans la liste du fournisseur |
| `followUps[].isMonitored` | Indique si la même question est déjà un prompt suivi |
| `followUps[].prompt` | Prompt source (`id`, `text`) |
| `followUps[].answer` | Réponse source : `id`, `providerId`, `modelId`, `createdAt` |

### Exemples de prompts

```text theme={null}
Quelles questions de suivi les fournisseurs IA suggèrent-ils après mes prompts ?
```

```text theme={null}
Liste les questions de suivi suggérées que je ne suis pas encore
```

### Scope OAuth

Requis : `read:prompts`

***

## get\_sponsored\_content

Détecte les contenus sponsorisés et les publicités qui apparaissent dans les réponses IA : quels annonceurs, produits et prompts déclenchent des publicités, et si des concurrents en font partie.

### 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 d’annonceurs et de publicités récentes renvoyés (par défaut : 10, maximum : 20) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | `totalAds`, `uniqueAdvertisers`, `uniquePrompts`, `uniqueProducts` |
| `topAdvertisers[]` | Par annonceur : `name`, `count`, `products`, `prompts`, `isCompetitor` |
| `recentAds[]` | Par publicité : `advertiserName`, `productName`, `description`, `promptText`, `provider`, `date` |

### Exemples de prompts

```text theme={null}
Des concurrents diffusent-ils des publicités dans les réponses IA sur mes Topics ?
```

```text theme={null}
Quels prompts déclenchent des contenus sponsorisés ?
```

### Scope OAuth

Requis : `read:visibility`


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