Repérez où votre marque sort d’une réponse d’IA

Citation Analysis montre les pages sur lesquelles s’appuie une réponse d’IA, la place de votre marque et quoi faire, en commençant par votre site.

Ce qui change

• queries : les recherches lancées par le moteur, chacune avec les pages trouvées.
• sources : chaque page récupérée par le moteur, avec cited pour distinguer les pages citées, sa position dans la recherche, les passages que le moteur dit citer, les marques nommées sur la page et un channel qui indique qui la contrôle : votre site, une autre marque, un média, un marchand, une plateforme d’avis, une communauté, la vidéo, les réseaux sociaux, une plateforme de blogs ou un ouvrage de référence.
• brands : votre marque, vos concurrents et chaque marque nommée par la réponse, dans l’ordre de la réponse, avec les pages citées et récupérées qui les nomment.
• visibility : l’étape atteinte par votre marque, de nommée dans la réponse à absente des pages que nous avons lues.
• actions : quoi faire, dans l’ordre de ce qui dépend de vous : vos pages d’abord, puis les plateformes où vous pouvez publier, enfin les médias à démarcher. Chaque action a des steps concrets et les pages qui l’appuient.
• insights : ce que partagent les pages citées, comme le canal, le format, la fraîcheur et les critères, et la place de votre marque, chacun avec les pages et liens qui l’appuient.

La réponse de POST /v1/citation-analysis porte désormais version: 4 et ces nouveaux champs. links garde sa forme, chaque insight liste ses pages dans sourceIds à côté de linkIds, et les résultats enregistrés avant ce changement gardent la forme de leur enregistrement. Le produit s’appelle désormais Citation Analysis : /v1/source-influence et /v1/geo-audit, les taskType SOURCE_INFLUENCE et GEO_AUDIT, ainsi que include.sourceInfluence et include.geoAudit fonctionnent toujours, et les réponses utilisent /v1/citation-analysis, CITATION_ANALYSIS et citationAnalysis.

Fonctionnement

Avec un taskId, les recherches et les pages récupérées viennent de la tâche de réponse elle-même quand le moteur les expose, comme ChatGPT et Google AI Overview. Vous pouvez aussi les envoyer dans queries et sous forme de citations avec cited: false. Les autres moteurs listent les pages citées.

Les recommandations viennent surtout de pages tierces. Dans les réponses ChatGPT étudiées, le moteur a récupéré une médiane de 20 pages et en a cité 3, et le site d’une marque recommandée a été récupéré dans 16 % des cas et cité dans 6,8 %. Les actions suivent ce chemin, en commençant par ce qui est entre vos mains :

• improve_page : votre page récupérée puis écartée par le moteur, ou citée alors que la réponse laisse votre marque de côté, avec ce qu’il faut ajouter pour qu’elle réponde au prompt comme les pages citées.
• publish_page : un brief de nouvelle page sur votre site pour une recherche où aucune de vos pages n’a été citée, sur le modèle des pages citées : type de page, modèle de titre, sections, preuves et date.
• post_on_platform : une page de marchand, de plateforme d’avis, de communauté, de vidéo ou de réseau social qui nomme vos concurrents, avec des étapes comme compléter votre fiche, inviter de vrais clients à laisser un avis ou répondre en tant que représentant identifié de la marque.
• pitch_publisher : une page éditoriale citée que seul son média peut modifier, avec ce qu’il faut lui envoyer.

Chaque correspondance indique quelle page dit ce que dit la réponse, et chaque action vise les pages exactes sur lesquelles elle s’appuie. L’étape not_found signifie qu’aucune page lue ne nomme votre marque. Envoyez brand pour recevoir visibility et actions, et ajoutez brandDomains et brandAliases pour compter vos pages et vos autres noms.

Cas d’usage

• Commencez par votre site : retravaillez la page écartée par le moteur ou préparez une nouvelle page sur le modèle des pages citées.
• Confiez à votre équipe marketplaces et communautés les fiches et les fils où apparaissent vos concurrents.
• Démarchez les médias avec la page exacte et les passages repris par la réponse.

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/citation-analysis \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "…",
    "brand": "Blueair",
    "competitors": ["Coway", "Levoit"],
    "brandDomains": ["blueair.com"]
  }'

Champs de la requête

taskIdstringObligatoire

Une de vos tâches de réponse terminées. Sa réponse et ses pages citées deviennent answer et citations.

brandstring

Le nom de votre marque. Avec lui, le résultat ajoute visibility et actions.

competitorsarray

Noms des concurrents à suivre dans la réponse et ses pages.

brandDomainsarray

Jusqu’à 10 noms d’hôte de vos sites, par exemple coway.com. Leurs pages comptent comme own.

brandAliasesarray

Jusqu’à 10 autres noms de votre marque, comme des gammes ou des graphies locales.

citations[].citedboolean

Par défaut true. Envoyez false pour une page récupérée mais non citée par le moteur, avec sa position et sa query si vous les avez.

countrystring

Pays depuis lequel les pages citées sont lues. Par défaut US.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

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

{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CITATION_ANALYSIS",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": "…", "creditsCharged": "…" },
  "response": {
    "version": 4,
    "answer": "The best-reviewed air purifiers depend on whether you …",
    "queries": [
      {
        "id": "q0",
        "text": "best air purifiers 2026 reviews independent testing …",
        "sourceIds": ["s0", "s1", "s2", "…", "s20"]
      }
    ],
    "sources": [
      {
        "id": "s13",
        "url": "https://www.blueair.com/products/blue-pure-211i-max",
        "domain": "blueair.com",
        "channel": "own",
        "cited": false,
        "position": 14,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [],
        "brandIds": ["b0"],
        "own": true,
        "paragraphs": []
      },
      {
        "id": "s14",
        "url": "https://www.target.com/p/levoit-core-300-air-…",
        "domain": "target.com",
        "channel": "retailer",
        "cited": true,
        "position": 15,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [
          "A compact, straightforward option with a 4.6/5 rating …"
        ],
        "brandIds": ["b2"],
        "own": false,
        "paragraphs": [
          {
            "id": "s14p1",
            "text": "Levoit Core 300 Air Purifier White … $99.99 …"
          }
        ]
      },
      "…"
    ],
    "brands": [
      {
        "id": "b0",
        "name": "Blueair",
        "role": "target",
        "rank": 2,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s11"],
        "retrievedSourceIds": ["s5", "s6", "s8", "s9", "s13"],
        "ownSourceIds": ["s11", "s13"]
      },
      {
        "id": "b1",
        "name": "Coway",
        "role": "competitor",
        "rank": 1,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s4", "s7"],
        "retrievedSourceIds": ["s0", "s5", "s6", "s9", "s10", "s18"],
        "ownSourceIds": []
      },
      {
        "id": "b2",
        "name": "Levoit",
        "role": "competitor",
        "rank": 3,
        "answerRanges": ["…"],
        "citedSourceIds": ["s3", "s7", "s14"],
        "retrievedSourceIds": ["s6", "s15", "s16"],
        "ownSourceIds": []
      },
      "…"
    ],
    "links": [
      {
        "id": "l40",
        "paragraphId": "s14p1",
        "answerRanges": ["…"],
        "explanation": "Lists the Levoit Core 300 at $99.99, …"
      },
      "…"
    ],
    "visibility": {
      "brandId": "b0",
      "stage": "mentioned",
      "rank": 2,
      "answerBrands": 5
    },
    "actions": [
      {
        "id": "a0",
        "type": "improve_page",
        "control": "owned",
        "priority": 1,
        "summary": "Update Blueair’s site with a current, …",
        "steps": [
          "Add a page on best air purifiers in 2026 that covers …",
          "Include Blueair models in direct comparisons using published …",
          "…"
        ],
        "sourceIds": ["s13"],
        "brandIds": ["b0"],
        "queryIds": ["q0"],
        "linkIds": []
      },
      {
        "id": "a1",
        "type": "post_on_platform",
        "control": "platform",
        "priority": 2,
        "summary": "Improve Blueair’s Target product listing with …",
        "steps": [
          "Ensure the Blueair listing clearly states the model, current …",
          "…",
          "Keep product details current and invite genuine purchasers to …"
        ],
        "sourceIds": ["s14"],
        "brandIds": ["b2"],
        "queryIds": ["q0"],
        "linkIds": ["l40"]
      },
      "…"
    ],
    "insights": [
      {
        "summary": "Blueair’s second-place position is reflected in …",
        "sourceIds": ["s1", "s3", "s11"],
        "linkIds": ["l1", "l12", "l36"]
      },
      "…"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.versionnumber

La forme du résultat. 4 pour les analyses avec recherches, pages récupérées, marques et actions.

response.answerstring

La réponse envoyée, telle quelle. Les plages sont des positions UTF-16 dans ce texte exact.

response.queriesarray

Les recherches lancées par le moteur, chacune avec un id, son text et les sourceIds trouvés.

response.sourcesarray

Chaque page récupérée par le moteur. cited distingue les pages citées des autres et channel indique qui contrôle la page (own, brand, editorial, retailer, review_platform, community, video, social, blog_platform ou reference). Elle a aussi position, queryIds, citedText, brandIds et own. Les pages citées portent des paragraphs.

response.brandsarray

Votre marque, vos concurrents et les marques citées par la réponse, chacune avec role, son rank dans la réponse, answerRanges et les pages citées et récupérées qui la nomment.

response.linksarray

Chaque lien associe un paragraphe aux answerRanges correspondants et à une explanation d’une phrase.

response.visibilityobject

Jusqu’où votre marque est allée : stage vaut mentioned, on_cited_page, on_retrieved_page ou not_found, avec son rank et answerBrands. null sans brand.

response.actionsarray

Ce qu’il faut faire, par priority : d’abord le travail owned sur votre site (improve_page, publish_page), puis les publications platform (post_on_platform), enfin l’outreach (pitch_publisher). Chaque action a son control, un summary, 1 à 5 steps et les sources, marques, recherches et liens qui l’appuient. Vide sans brand.

response.insightsarray

Jusqu’à 4 courtes lectures de ce que partagent les pages citées et de la place de votre marque, chacune avec ses pages dans sourceIds et ses liens dans linkIds.

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

Le tarif reste le même : les crédits sont réservés au début de l’analyse et réglés à la fin.