L’analyse des réponses passe à 1 crédit

Une tâche de réponse avec include.analysis renvoie chaque marque citée avec son rang, sa recommandation et son sentiment, ainsi que le type de chaque site cité, à moitié prix.

Ce qui change

• L’analyse des réponses coûte 1 crédit par tâche en plus du prix du moteur (avant : 2). Une réponse ChatGPT avec analyse coûte 2 crédits au total.
• Chaque site cité reçoit un kind plus précis : editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video et institution pour les sites connus. Tout autre site est classé une fois comme brand, content ou l’un de ces types, et le résultat est réutilisé.
• Une graphie que l’analyse confirme comme le nom propre d’une marque, par exemple 컬리 pour Kurly, est conservée et retrouvée par règle dans les réponses suivantes.
• L’analyse fonctionne sur les tâches CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, NAVER_AI_BRIEF et NAVER_AI_TAB.

Fonctionnement

Un modèle décide quels noms sont des marques, laquelle est la vôtre, ainsi que recommended et sentiment. Les positions, les rangs, la correspondance des noms et les types de sources sont calculés par des règles : une même lecture donne le même résultat.

Votre marque et vos concurrents sont retrouvés par nom et alias avec les règles d’un monitor : mots entiers en alphabet latin, n’importe où en coréen, japonais, chinois et thaï. Le modèle lit les 40 000 premiers caractères de la réponse, et l’analyse ajoute quelques secondes avant la fin de la tâche.

Cas d’usage

• Calculez le taux de mention, la position moyenne et la part de voix de tous vos prompts directement à partir de analysis.targets.
• Comparez la façon dont chaque moteur parle de votre marque et de vos concurrents avec recommended et sentiment.
• Voyez quels types de sites les moteurs citent dans votre catégorie avec sources[].kind, et où votre site apparaît comme owned.

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/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"]
        }
      ]
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.promptstringObligatoire

La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.include.analysisbooleanObligatoire

Avec true, analysis s’ajoute : chaque marque citée dans la réponse, avec son rang, sa recommandation, son sentiment et le type de chaque site cité. 1 crédit en plus du prix du moteur.

payload.brandstring

Le nom de votre marque, jusqu’à 200 caractères. Il figure dans analysis.targets avec le rôle brand.

payload.brandAliasesarray

Jusqu’à 20 autres noms que la réponse peut donner à votre marque. Uniquement avec brand.

payload.brandDomainsarray

Jusqu’à 20 de vos sites, par exemple acme-crm.example. Une citation sur l’un d’eux ou un sous-domaine a le kind owned. Uniquement avec brand.

payload.competitorsarray

Jusqu’à 50 concurrents. Chacun est un nom, ou { name, aliases, domains } avec jusqu’à 20 alias et 20 domaines. Ils figurent dans analysis.targets avec le rôle competitor.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "…",
    "analysis": {
      "version": 1,
      "status": "ok",
      "brands": [
        {
          "name": "Northwind",
          "rank": 1,
          "role": "competitor",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9
        },
        {
          "name": "Acme CRM",
          "rank": 2,
          "role": "brand",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5
        },
        {
          "name": "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
        }
      ]
    }
  }
}

response.analysis.statusstring

ok quand l’analyse a tourné, no_answer quand le moteur n’a renvoyé aucun texte de réponse, failed quand l’analyse n’a pas pu tourner. Seul ok est facturé.

response.analysis.brandsarray

Chaque marque citée dans la réponse, dans l’ordre de sa première mention. rank commence à 1, et un produit compte pour son fabricant. Chacune porte recommended, sentiment et sentimentScore.

response.analysis.targetsarray

Les marques envoyées, dans votre ordre, chacune avec mentioned, son rank dans brands et cited si l’un de ses domaines est cité.

response.analysis.sources[].kindstring

Le type de chaque site cité : owned et competitor d’après vos domaines, puis editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video, institution, brand, content ou other.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Tarif

La tâche réserve 1 crédit pour l’analyse à l’envoi et le facture uniquement quand analysis.status vaut ok. Avec no_answer ou failed, le crédit est libéré et la tâche se termine avec sa réponse. Les plans et le prix des crédits sont sur https://querying.ai/pricing .