> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Analyse de la réponse : mentions de marque, rang, sentiment et types de source > Ajoutez include.analysis à une tâche de réponse et obtenez chaque marque citée, la façon dont la réponse la traite et le type de site de chaque citation. Réglez `payload.include.analysis` sur `true` et la tâche renvoie, à côté de la réponse, chaque marque qu'elle cite dans l'ordre, si elle recommande chacune et sur quel ton elle en parle, si votre marque et vos concurrents apparaissent, et quel type de site est chaque citation. Vous calculez ainsi le taux de mention, la position moyenne, le sentiment, la part de voix et la part des sources sans faire tourner votre propre modèle sur la réponse. ## Requête ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "CHATGPT", "payload": { "prompt": "best CRM for a small team", "country": "US", "include": { "analysis": true }, "brand": "Acme CRM", "brandAliases": ["Acme"], "brandDomains": ["acme-crm.example"], "competitors": ["Northwind", { "name": "Contoso CRM", "aliases": ["Contoso"], "domains": ["contoso-crm.example"] }] } }' ``` | Champ | Obligatoire | Description | | - | - | - | | `include.analysis` | Oui | `true` pour lancer l'analyse. | | `brand` | Non | Le nom de votre marque, jusqu'à 200 caractères. Pas une URL : mettez les sites dans `brandDomains`. | | `brandAliases` | Non | Jusqu'à 20 autres noms pour votre marque. Seulement avec `brand`. | | `brandDomains` | Non | Jusqu'à 20 sites, comme `acme-crm.example`. Une citation sur le site ou un sous-domaine est la vôtre. Seulement avec `brand`. | | `competitors` | Non | Jusqu'à 50 concurrents. Chacun est un nom, ou `{ name, aliases, domains }` avec jusqu'à 20 alias et 20 domaines. | Chaque nom doit compter au moins deux caractères, ou avoir un alias qui les compte. Sans `brand` ni `competitors`, l'analyse liste quand même chaque marque citée par la réponse. ## Moteurs pris en charge `CHATGPT`, `GEMINI`, `PERPLEXITY`, `GOOGLE`, `AIMODE`, `NAVER_AI_BRIEF` et `NAVER_AI_TAB` (et leurs alias). Sur une tâche `CHATGPT` avec `followUps`, l'analyse lit la première réponse. ## Crédits L'analyse coûte **1 crédit** par tâche en plus du prix du moteur. La tâche le réserve à l'envoi et ne le facture que quand `analysis.status` vaut `ok`. Voir [Crédits et limites](/fr/concepts/credits-and-limits.md). ## Réponse La `response` de la tâche reçoit un objet `analysis`. Par exemple : ```json theme={"theme":"css-variables"} { "analysis": { "version": 1, "status": "ok", "brands": [ { "name": "Northwind", "domain": null, "writtenAs": "Northwind", "spellings": ["Northwind"], "rank": 1, "role": "competitor", "recommended": true, "sentiment": "positive", "sentimentScore": 0.9 }, { "name": "Acme CRM", "domain": "acme-crm.example", "writtenAs": "Acme", "spellings": ["Acme", "Acme CRM"], "rank": 2, "role": "brand", "recommended": true, "sentiment": "positive", "sentimentScore": 0.5 }, { "name": "Fabrikam", "domain": "fabrikam.example", "writtenAs": "Fabrikam", "spellings": ["Fabrikam"], "rank": 3, "role": null, "recommended": false, "sentiment": "neutral", "sentimentScore": 0 } ], "targets": [ { "name": "Acme CRM", "role": "brand", "mentioned": true, "rank": 2, "recommended": true, "sentiment": "positive", "sentimentScore": 0.5, "cited": true }, { "name": "Northwind", "role": "competitor", "mentioned": true, "rank": 1, "recommended": true, "sentiment": "positive", "sentimentScore": 0.9, "cited": false }, { "name": "Contoso CRM", "role": "competitor", "mentioned": false, "rank": null, "recommended": null, "sentiment": null, "sentimentScore": null, "cited": false } ], "sources": [ { "position": 1, "url": "https://www.acme-crm.example/pricing", "domain": "acme-crm.example", "kind": "owned", "brand": "Acme CRM" }, { "position": 2, "url": "https://www.g2.com/categories/crm", "domain": "g2.com", "kind": "reviews", "brand": null } ] } } ``` | Champ | Description | | - | - | | `status` | `ok`, `no_answer` ou `failed`. Voir [Statuts](#statuts). | | `brands` | Chaque marque citée par la réponse, dans l'ordre de sa première mention. Un produit compte pour son fabricant : "MacBook Air" donne le rang d'Apple. `rank` commence à 1. `role` vaut `brand` ou `competitor` pour les marques envoyées et `null` pour les autres. | | `brands[].name`, `domain`, `writtenAs`, `spellings` | Pour votre marque et vos concurrents, `name` est le nom que vous avez envoyé. Pour toute autre marque, c'est le nom propre de la marque, le même dans toutes les langues : son nom officiel en alphabet latin ou, à défaut, son nom d'origine. 마켓컬리 et 컬리 sont tous deux `Kurly`. `domain` est le site de la marque : le premier des domaines envoyés, celui trouvé pour elle, ou `null`. `spellings` liste chaque graphie que la réponse utilise pour le nom de la marque, dans l'ordre de sa première apparition : Baemin liste ainsi 배민 et 배달의민족. Un produit ou une description écrits après le nom ne font pas partie de la graphie. `writtenAs` est la première d'entre elles. | | `targets` | Les marques envoyées, dans votre ordre, chacune avec `mentioned` et son `rank` dans `brands`. `cited` vaut `true` quand une citation est sur l'un de ses domaines, et `false` si vous n'avez envoyé aucun domaine. | | `recommended` | La réponse recommande la marque ou la présente comme un bon choix. | | `sentiment`, `sentimentScore` | La position de la réponse envers la marque, sur cinq niveaux notés 0.9, 0.5, 0, -0.5 et -0.9. Les éloges ou critiques visant d'autres marques ne comptent pas, et une recommandation ou un avertissement l'emporte sur une remarque en passant. | | `sources[].kind` | `owned` et `competitor` viennent des domaines envoyés. Les sites connus suivent des listes fixes : `editorial` (actualités et magazines), `review_media` (médias de tests et d'avis produits), `pr_wire`, `reviews` (plateformes d'avis d'utilisateurs), `commerce`, `social` (réseaux sociaux), `blog` (plateformes de blogs), `community` (forums, questions-réponses et wikis), `video` et `institution` (administrations et universités). Un modèle classe une seule fois tout autre site et réutilise le résultat : `brand` (le site d'une entreprise), `content` (un site indépendant ou un blog personnel) ou l'un des types ci-dessus. `other` reste pour les sites qui n'entrent dans aucun type, comme les moteurs de recherche et les outils, ou qui n'ont pas pu être classés. | ## Comment elle décide * Quels noms sont des marques, lequel est le vôtre, `recommended` et `sentiment` sont jugés par un modèle. Les positions, les rangs, la recherche des noms et le type de source sont calculés par des règles : une même lecture du modèle donne donc le même résultat. * Votre marque et vos concurrents sont trouvés par leurs noms et alias avec les mêmes règles qu'un [moniteur](/fr/monitors.md#correspondance-des-noms) : mots entiers en alphabet latin, n'importe où en coréen, japonais, chinois et thaï, jamais dans un lien de citation. Le modèle relie aussi les autres graphies qu'il trouve. Une graphie qu'il confirme comme le nom même de la marque, comme 컬리 pour Kurly, est conservée et retrouvée par les règles dans les réponses suivantes. Un nom absent de la réponse n'est jamais signalé. * Si votre nom correspond mais que le modèle ne l'a pas lu comme une marque dans cette réponse (un mot courant employé autrement), la marque apparaît avec `recommended`, `sentiment` et `sentimentScore` à `null`. * Un modèle nomme chaque marque que vous n'avez pas envoyée la première fois qu'une réponse emploie cette graphie, et ce nom et ce site sont réutilisés pour toutes les réponses suivantes. Les marques déjà nommées avec un site cité ou une graphie proche lui sont proposées, pour qu'une succursale ou une autre écriture aboutisse au même nom. Si la désignation échoue, la marque garde la graphie de la réponse et `domain` vaut `null`. * Un site est une marque : les marques nommées avec le même site apparaissent une fois, sous le nom propre du site (Baemin pour baemin.com) ou, à défaut, le premier nom donné à ce site, donc 아임웹 et I'mweb sont une seule marque, et une marque trouvée sur le site d'une marque envoyée est cette marque. Une publication sur une plateforme de blogs, de communauté, de vidéo ou un réseau social n'est pas rattachée à une marque que vous n'avez pas envoyée, même sur la plateforme de cette marque, comme blog.naver.com pour NAVER. * Un nom que le modèle ne lit pas comme une marque, comme un mot générique, un lieu ou un soin, est omis. Les marques qu'une réponse écrit sous un seul nom, comme « 마켓컬리, 오아시스마켓, SSG닷컴 », comptent chacune comme une marque, et une description après un nom n'en fait pas partie. * Le modèle lit les 40 000 premiers caractères de la réponse. Une marque citée pour la première fois après n'est pas signalée. * L'analyse retarde de quelques secondes la fin de la tâche. ## Statuts | `status` | Signification | Facturé | | - | - | - | | `ok` | L'analyse s'est exécutée. | 1 crédit | | `no_answer` | Le moteur a terminé sans texte de réponse, comme une recherche Google sans AI Overview. Aucune marque envoyée n'est mentionnée. | Non | | `failed` | L'analyse n'a pas pu s'exécuter. `error` vaut `ANALYSIS_FAILED`, `ANALYSIS_TIMEOUT` ou `ANALYSIS_UNAVAILABLE`. La tâche se termine quand même avec sa réponse. | Non | ## Erreurs | Statut | Code | Quand | | - | - | - | | `422` | `VALIDATION_ERROR` | `include.analysis` n'est pas un booléen, le moteur ne prend pas en charge l'analyse, ou `brand`, `brandAliases`, `brandDomains` ou `competitors` enfreint les règles ci-dessus. `details[].field` nomme le champ. | ## Voir aussi * [Markdown et réponses brutes](/fr/engines/response-options.md) * [Suivi GEO](/fr/monitors.md) : lancez la même analyse selon un calendrier. * [Vue d'ensemble des moteurs](/fr/engines/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.