Outils concurrents

Consultez Compatibilité des filtres 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.

get_competitors

Classe les concurrents selon leurs mentions dans un périmètre d’analyse. Sans fenêtre, l’outil renvoie les résultats sur tout l’historique ; utilisez une période glissante ou des dates personnalisées incluses, éventuellement combinées avec un Topic et/ou un Tag.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque
`relationship`	string	Non	`SELF`, `DIRECT`, `INDIRECT`, `ECOSYSTEM`, `COMPLEMENTARY` ou `SELF_DIRECT`
`period`	integer ou string	Non	Jours glissants (1 à 3650), `"all"`, ou `"custom"` avec des dates ; omettez-le pour tout l’historique
`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	Ancien alias pour un seul fournisseur ou modèle
`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
`limit`	integer	Non	Nombre maximal de concurrents renvoyés (par défaut : 20, maximum : 100)

Types de relation

Type	Description
`SELF`	Votre propre marque
`DIRECT`	Concurrents directs (même catégorie de produits)
`INDIRECT`	Concurrents indirects (solutions voisines)
`ECOSYSTEM`	Acteurs de l’écosystème (produits complémentaires)
`COMPLEMENTARY`	Produits ou services complémentaires
`SELF_DIRECT`	Votre marque et ses concurrents directs dans un même classement

Résultat

Champ	Type	Description
`brandName`	string	Nom de la marque suivie
`appliedFilters`	object	Fenêtre d’analyse et filtres de taxonomie effectivement utilisés pour le classement
`competitors[].id`	string	Identifiant du domaine concurrent
`competitors[].name`	string	Nom du concurrent
`competitors[].domain`	string ou null	Domaine du concurrent
`competitors[].relationship`	string	Type de relation
`competitors[].mentions`	number	Nombre de mentions dans le périmètre demandé
`competitors[].uniqueAnswers` / `uniqueQuestions`	number	Réponses et questions suivies distinctes qui contribuent aux mentions
`competitors[].shareOfVoice`	number ou null	Part des mentions SELF et DIRECT dans le périmètre ; null pour les autres relations
`competitors[].shareOfResponses` / `mentionRate`	number ou null	Taux de visibilité au niveau des réponses, lorsqu’ils sont disponibles
`competitors[].avgPosition`	number ou null	Position moyenne dans les réponses du périmètre demandé
`competitors[].avgSentiment`	number ou null	Sentiment moyen (0 à 100)
`competitors[].providers`	string[]	Fournisseurs qui apportent des données sur ce concurrent

Exemple de sortie

## Competitors for Acme Corp

| Rank | Name | Relationship | Mentions | Share of Voice | Avg Position | Sentiment | Competitor Domain ID |
|------|------|--------------|----------|----------------|--------------|-----------|----------------------|
| 1 | CompetitorA | DIRECT | 892 | 34.26% | 2.3 | 75/100 | 11111111-1111-4111-8111-111111111111 |
| 2 | CompetitorB | DIRECT | 654 | 25.11% | 3.1 | 72/100 | 22222222-2222-4222-8222-222222222222 |
| 3 | Acme Corp | SELF | 612 | 23.50% | 2.8 | 78/100 | 33333333-3333-4333-8333-333333333333 |
| 4 | CompetitorC | DIRECT | 445 | 17.09% | 4.2 | 68/100 | 44444444-4444-4444-8444-444444444444 |
| 5 | ToolX | INDIRECT | 234 | - | 5.1 | 71/100 | 55555555-5555-4555-8555-555555555555 |

Exemples de prompts

Qui sont mes concurrents dans les réponses IA ?

Montre-moi uniquement les concurrents directs

Quelles marques apparaissent le plus souvent à côté de la mienne ?

Classe ma marque et mes concurrents directs pour ce Tag sur les 30 derniers jours

Scope OAuth

Requis : read:competitors

get_competitor_evolution

Suit l’évolution de la présence d’un concurrent dans le temps : tendances des mentions, de la position et du sentiment.

Paramètres

Paramètre	Type	Requis	Description
`brandId`	string	Oui	L’identifiant de marque
`competitorId`	string	Oui	L’identifiant du domaine concurrent (issu de `get_competitors`)
`period`	integer ou string	Non	Fenêtre d’analyse globale ; 30 jours par défaut
`groupBy`	string	Non	`day` (par défaut) ou `week`

Résultat

Tableau de points de données, un par jour :

Champ	Type	Description
`date`	string	Date (YYYY-MM-DD)
`mentions`	number	Mentions ce jour-là
`avgPosition`	number	Position moyenne
`avgSentiment`	number	Sentiment moyen

Exemple de sortie

## CompetitorA - Evolution Over Time

Relationship: DIRECT

| Date | Mentions | Avg Position | Sentiment |
|------|----------|--------------|-----------|
| 2025-01-21 | 28 | 2.5 | 73/100 |
| 2025-01-22 | 31 | 2.3 | 74/100 |
| 2025-01-23 | 35 | 2.1 | 76/100 |
| 2025-01-24 | 29 | 2.4 | 75/100 |
| 2025-01-25 | 38 | 2.0 | 77/100 |

Exemples de prompts

Comment CompetitorA a-t-il évolué au cours du dernier mois ?

CompetitorB gagne-t-il ou perd-il en visibilité ?

Montre-moi l’évolution des mentions de ma propre marque

Appelez d’abord get_competitors pour trouver le competitorId à suivre.

Scope OAuth

Requis : read:competitors

get_competitor_comparison

Comparaison directe de la marque avec ses principaux concurrents directs : vos statistiques, votre rang sur le marché, les statistiques des principaux concurrents, un bilan victoires/défaites par concurrent sur le nombre de mentions, et la menace perçue la plus forte.

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
`competitorIds`	string[]	Non	Limite la comparaison à 1 à 10 identifiants de domaines concurrents

Résultat

Champ	Description
`period` / `periodLabel`	La fenêtre analysée
`yourStats`	Votre marque : `name`, `mentionCount`, `avgSentiment`, `avgPosition` (null si elle n’est pas mentionnée sur la période)
`marketRank`	Votre rang parmi les marques SELF et DIRECT selon le nombre de mentions
`totalCompetitors`	Nombre de concurrents directs trouvés
`topCompetitors[]`	Par concurrent : `name`, `domain`, `mentionCount`, `avgSentiment`, `avgPosition`
`headToHead[]`	Les 5 principaux duels : `competitor`, `yourMentions`, `theirMentions`, `winner` (you/them/tie), ainsi que votre sentiment et votre position face aux leurs
`insights`	`winsAgainstTop5`, `lossesAgainstTop5`, `biggestThreat`

Exemples de prompts

Comment est-ce que je me situe face à mes principaux concurrents en ce moment ?

Quels concurrents est-ce que je devance, et lesquels me devancent ?

Scope OAuth

Requis : read:competitors

Bien démarrer

Référence des outils

Exemples

Workflows

get_competitors

Paramètres

Types de relation

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

get_competitor_evolution

Paramètres

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

get_competitor_comparison

Paramètres

Résultat

Exemples de prompts

Scope OAuth

​get_competitors

​Paramètres

​Types de relation

​Résultat

​Exemple de sortie

​Exemples de prompts

​Scope OAuth

​get_competitor_evolution

​Paramètres

​Résultat

​Exemple de sortie

​Exemples de prompts

​Scope OAuth

​get_competitor_comparison

​Paramètres

​Résultat

​Exemples de prompts

​Scope OAuth

get_competitors

Paramètres

Types de relation

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

get_competitor_evolution

Paramètres

Résultat

Exemple de sortie

Exemples de prompts

Scope OAuth

get_competitor_comparison

Paramètres

Résultat

Exemples de prompts

Scope OAuth