GEO Score : mesurer ce que la recherche ChatGPT garde d'une page

Utilisez GEO Score pour vérifier une page que vous voulez voir citée par ChatGPT. Le score est la part de ce qu’une personne lit sur la page, texte des images compris, que la recherche ChatGPT garde dans sa copie de la page. direct donne la part que ChatGPT reçoit lorsqu’il ouvre lui-même la page, comme quand quelqu’un lui donne l’URL. Chaque élément que la recherche ChatGPT ne garde pas est accompagné de sa cause, et analysis transforme les causes en corrections.

Noter une page

curl -X POST https://api.querying.ai/v1/geo-score \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://global.oliveyoung.com/product/detail?prdtNo=GA240322874", "country": "US" }'

La tâche est acceptée et mise en file d’attente :

{
  "success": true,
  "task": {
    "id": "0b6c1f7e-...",
    "taskType": "GEO_SCORE",
    "status": "QUEUED",
    "priority": 1,
    "createdAt": "2026-10-21T09:00:00.000Z"
  },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 }
}

Lisez le résultat avec GET /v1/async/task/{id}, ou ajoutez webhook.url à la requête pour le recevoir à la fin de la tâche. La plupart des pages prennent 1 à 3 minutes : interrogez toutes les 10 à 15 secondes. La tâche fonctionne comme toute autre tâche asynchrone et le résultat se trouve dans response. Le schéma de la requête figure dans la référence de l’API.

Champs de la requête

Champ	Obligatoire	Description
`url`	Oui	La page à noter : une URL `http` ou `https` sur un hôte public et le port par défaut, jusqu’à 2 048 caractères.
`country`	Non	Le pays du lecteur : `US` (par défaut) ou `KR`. La page est rendue depuis une adresse de ce pays, dans sa langue et son fuseau horaire.
`idempotencyKey`	Non	Rend sûr le renvoi d’une soumission. Voir Idempotence.
`priority`	Non	Entier de `1` à `10`, `1` par défaut. Les valeurs hors plage sont ramenées dans la plage. Reprise dans les métadonnées de la tâche ; ne garantit pas l’ordre d’exécution. Voir Tâches asynchrones.
`webhook.url`	Non	Adresse à laquelle la tâche terminée est envoyée en POST. Voir Webhooks.

Tout autre champ renvoie 400 VALIDATION_ERROR.

Comment une page est notée

Accès. robots.txt est lu pour OAI-SearchBot, ChatGPT-User et GPTBot. La page est récupérée sous chacun d’eux et comme un navigateur, depuis une adresse aux États-Unis, d’où ChatGPT-User récupère les pages.
Ce que lit une personne. Un navigateur dans country affiche la page et la parcourt jusqu’en bas, et le texte de ses grandes images est lu ligne par ligne. Les lignes sur le sujet propre de la page deviennent des éléments. Les menus, pieds de page, autres produits, avis de clients, boutons et publicités restent hors du score.
Ce que garde la recherche ChatGPT. Un navigateur affiche la page sous OAI-SearchBot, le robot qui alimente la recherche ChatGPT, depuis une adresse aux États-Unis, sans laisser sortir aucune requête de données. Sa copie est le texte du HTML envoyé par le serveur et le texte que les scripts de la page en tirent, texte masqué et texte alternatif des images compris. Le texte dans les images et le contenu que la page charge après son ouverture n’y figurent pas, pas plus que dans la recherche ChatGPT.
Ce que reçoit ChatGPT en ouvrant la page. Le HTML que reçoit ChatGPT-User est lu comme le lit le lecteur de ChatGPT : son texte, le texte masqué et le texte alternatif des images, sans scripts. Une image compte quand ChatGPT peut l’ouvrir et la lire : le HTML donne l’image comme src d’un img, en JPEG, PNG ou WebP, à une taille où le texte reste lisible.
Si ChatGPT ouvre la page. On demande deux fois à ChatGPT en production d’ouvrir la page. Ses réponses ne sont pas notées : elles montrent seulement s’il a ouvert la page.
Placer chaque élément. Un élément est read quand la copie de la recherche le contient, et missing avec sa raison sinon. direct le place de la même façon dans ce que ChatGPT reçoit en ouvrant la page. Le code décide de chaque élément, donc une page qui n’a pas changé obtient le même score.

Lire le résultat

La page OLIVE YOUNG ci-dessus donne ceci, réduit aux champs principaux :

{
  "level": "url",
  "url": "https://global.oliveyoung.com/product/detail?prdtNo=GA240322874",
  "finalUrl": "https://global.oliveyoung.com/product/detail?prdtNo=GA240322874",
  "score": 29,
  "direct": { "score": 29, "read": 16 },
  "pageType": "product",
  "access": {
    "verdict": "open",
    "chatgpt": { "opened": true, "inSearch": false, "lines": 819, "searchedFor": [], "observedAt": "2026-10-21T17:35:37.050Z" },
    "search": { "refused": false, "lines": 1343 },
    "robots": {
      "OAI-SearchBot": { "allowed": true, "named": false },
      "ChatGPT-User": { "allowed": true, "named": false },
      "GPTBot": { "allowed": true, "named": false }
    },
    "noindex": { "noindex": false },
    "probes": [
      { "agent": "ChatGPT-User", "status": 200, "blocked": false },
      { "agent": "OAI-SearchBot", "status": 200, "blocked": false },
      { "agent": "browser", "status": 200, "blocked": false }
    ]
  },
  "reading": {
    "score": 29,
    "facts": 55,
    "read": 16,
    "locations": { "html": 16, "rendered_only": 13, "image": 26 },
    "items": [
      {
        "label": "COSRX Vitamin E Vitalizing Sunscreen SPF 50+",
        "value": "COSRX Vitamin E Vitalizing Sunscreen SPF 50+",
        "where": "html",
        "line": 1,
        "status": "read",
        "direct": { "status": "read" }
      },
      {
        "label": "US$24.00",
        "value": "US$24.00",
        "where": "rendered_only",
        "status": "missing",
        "reason": "javascript_only",
        "direct": { "status": "missing", "reason": "javascript_only" }
      },
      {
        "label": "Strong and effective sun protection",
        "value": "Strong and effective sun protection",
        "where": "image",
        "status": "missing",
        "reason": "image_only",
        "direct": { "status": "missing", "reason": "image_only" },
        "foundIn": "image https://cdn-image.oliveyoung.com/slicedImg/editor/1157/f9e08334-....jpg (no alt text): the HTML ChatGPT receives has no img with this picture as its src"
      }
    ]
  },
  "causes": [
    { "reason": "javascript_only", "labels": ["4.6", "21 review", "30%", "US$24.00", "US$16.80", "..."] },
    { "reason": "image_only", "labels": ["Strong and effective sun protection", "Key Ingredients", "..."] }
  ],
  "analysis": {
    "summary": "ChatGPT search keeps 16 of 55 facts of the page. The biggest issue: 26 facts are written only inside an image, among them Strong and effective sun protection; Key Ingredients; Tocopherol (Vitamin E) (47 points). Fixing the confirmed issues could raise the score to about 100.",
    "potential": 100,
    "direct": "When ChatGPT opens the page itself, as when a person gives it the URL, it receives 16 of 55 facts (score 29).",
    "issues": [
      {
        "code": "image_only",
        "basis": "confirmed",
        "points": 47,
        "title": "26 facts are written only inside an image",
        "detail": "People read these values in the page's image, but the HTML has no text for them. ChatGPT search keeps a page's text and its images' alt text, not the text inside its images.",
        "fix": "Write this content as text in the page's HTML, next to the image or in place of it (a size chart as a table, rules and notes as sentences), or at least in the image's alt text.",
        "facts": [{ "label": "Key Ingredients", "value": "Key Ingredients", "foundIn": "image https://cdn-image.oliveyoung.com/... (no alt text): the HTML ChatGPT receives has no img with this picture as its src" }],
        "evidence": ["image https://cdn-image.oliveyoung.com/... (no alt text): the HTML ChatGPT receives has no img with this picture as its src"]
      },
      { "code": "javascript_only", "basis": "confirmed", "points": 24, "title": "13 facts are loaded only after the page opens", "...": "..." }
    ]
  },
  "reference": "rendered"
}

`score`

La part des éléments que garde la recherche ChatGPT, de 0 à 100. Chaque élément pèse autant. Le score vaut 0 quand robots.txt exclut la page de la recherche ChatGPT et quand le site refuse le robot de la recherche ChatGPT. reading.score garde la part avant que robots.txt ne ramène le score à 0.

`direct`

Ce que ChatGPT reçoit lorsqu’il ouvre lui-même la page, comme quand quelqu’un lui donne l’URL. direct.score est la part des éléments présents dans le HTML que reçoit ChatGPT-User et dans les images que ChatGPT peut ouvrir, et direct.read les compte. Il vaut 0 quand ChatGPT n’a pas pu ouvrir la page. Les deux scores divergent là où la page écrit du texte dans des images ou le dessine avec des scripts : la recherche ChatGPT ne garde pas le texte des images et garde ce que les scripts tirent du HTML, tandis que le lecteur de ChatGPT ouvre les images qu’il peut lire et n’exécute aucun script. Une page produit alimentaire dont l’étiquette nutritionnelle est un JPEG en taille réelle a obtenu 56 pour la recherche et 93 en ouverture directe.

`access`

`verdict`	Signification
`open`	ChatGPT a ouvert la page. `chatgpt.lines` est le nombre de lignes que son lecteur en a tirées.
`search_only`	ChatGPT n’a pas pu ouvrir la page et ne l’a trouvée que dans ses résultats de recherche. `direct.score` vaut 0.
`blocked`	ChatGPT n’a pas pu ouvrir la page ni la trouver dans la recherche. `direct.score` vaut 0 et `blockedBy` indique qui l’a refusé.
`search_opt_out`	robots.txt exclut la page de la recherche ChatGPT, donc le score vaut 0.

search.refused vaut true quand le site refuse le robot de la recherche ChatGPT, ce qui ramène le score à 0, et search.lines compte les lignes de la copie de la recherche. blockedBy vaut user_agent quand le site refuse l’agent ChatGPT-User depuis n’importe quelle adresse, openai_addresses quand il sert cet agent depuis notre adresse et refuse celles d’OpenAI, et site quand il refuse aussi un navigateur. robots donne la ligne de robots.txt décisive pour chaque agent d’OpenAI, noindex signale une directive noindex et où elle est posée, et probes liste le statut reçu par chaque récupération.

`reading.items[]`

Une entrée par élément :

Champ	Description
`label`, `value`	L’élément tel que la page l’affiche.
`where`	Où la page l’a : `html`, `structured_data`, `script`, `rendered_only`, `frame` ou `image`. `rendered_only` est sur la page affichée et dans aucun HTML que reçoit ChatGPT.
`status`	`read` quand la recherche ChatGPT le garde, sinon `missing`.
`reason`	Pourquoi la recherche ChatGPT ne le garde pas (ci-dessous).
`direct`	`status` et `reason` pour ce que ChatGPT reçoit en ouvrant la page.
`rendering`	`status` dans la copie de la page destinée aux agents IA : `read` quand la copie contient l’élément dans son texte.
`foundIn`	Où la page a un élément manquant, comme une ligne du HTML, ou l’URL d’une image et la raison pour laquelle ChatGPT ne peut pas la lire.

reading.locations compte les éléments par where, ce qui montre ce qu’il reste à corriger une fois que ChatGPT peut ouvrir la page. causes[] regroupe les éléments manquants par raison.

`reason`	Signification	Correction
`blocked`	Le site refuse le robot de la recherche ChatGPT. Dans `direct`, l’élément est dans le HTML ou dans une image que ChatGPT peut lire, et ChatGPT n’a pas pu ouvrir la page.	Laissez passer OAI-SearchBot et ChatGPT-User, par leur agent utilisateur et les adresses publiées par OpenAI.
`javascript_only`	La page charge l’élément après son ouverture. Dans `direct`, l’élément n’apparaît qu’après l’exécution des scripts.	Mettez-le dans le HTML envoyé par le serveur, rendu côté serveur ou à la compilation.
`structured_data_only`	Il n’est que dans du JSON-LD ou des balises meta.	Affichez-le aussi dans le texte de la page.
`image_only`	Il n’est écrit que dans une image, et la recherche ChatGPT ne garde pas le texte des images. Dans `direct`, ChatGPT ne peut pas lire l’image : le HTML ne donne pas l’image comme `src` d’un `img`, le `src` est un fichier plus petit, ou elle est servie en AVIF.	Écrivez-le en texte dans le HTML ou dans le texte alternatif de l’image.

`analysis`

summary donne le score, le problème principal et le score une fois les problèmes confirmés corrigés (potential). direct dit ce que ChatGPT reçoit lorsqu’il ouvre lui-même la page, ou qui l’empêche de l’ouvrir et la correction. Chaque entrée de issues[] contient la cause (detail), la correction (fix), les éléments qu’elle coûte (facts), ses preuves et les points qu’elle retire au score. Les problèmes d’accès qui bloquent le score à 0 viennent d’abord, puis le reste par points. basis vaut confirmed : notre propre lecture de la page (son HTML, ses rendus, ses images, robots.txt, les réponses HTTP) montre le problème. Le texte de analysis est en anglais.

`markdown`

La page que voit une personne, en Markdown, avec le texte de ses images à la place des images. Le contenu propre de la page, que le score vérifie, se trouve sous ses titres et libellés. Les menus, avis et autres parties autour sont repliés en une ligne chacun. Chaque élément que la recherche ChatGPT ne garde pas est marqué à sa place, _(missing: …)_ avec la raison, et l’en-tête indique combien d’éléments ChatGPT reçoit en ouvrant la page. L’en-tête et les marques sont dans la langue de la page : anglais, coréen, japonais, chinois, espagnol, français, allemand ou portugais, et anglais pour toute autre. Une page en français indique _(manquant: …)_. Un extrait de la page OLIVE YOUNG, qui est en anglais :

4.6 _(missing: loaded after the page opens)_
21 review _(missing: loaded after the page opens)_
US$16.80 _(missing: loaded after the page opens)_

> **Text in image** f9e08334-9760-45c5-89bb-…66eb1752.jpg · 52 lines · ChatGPT search keeps 10 of its 37 pieces
>
> Strong and effective sun protection _(missing)_
> Key Ingredients _(missing)_
> Tocopherol (Vitamin E) _(missing)_

_Other items (112 lines), reviews and questions (90), site menus and notices (57), buttons and tabs (46): Most Helpful · filter · Best …_

`screenshot`

Les quatre premiers écrans de la page telle qu’une personne la voit, en JPEG : une fenêtre de 1366×900, capturée en haut après avoir fait défiler la page jusqu’au bout. url sert de clé d’accès et ouvre le fichier jusqu’à expiresAt, 30 jours après la tâche. Une page dont l’image n’a pas pu être capturée arrive sans screenshot, et une image qui n’a pas pu être enregistrée a status: "failed".

`rendering`

La page rendue pour les agents IA. La copie est le HTML qu’a dessiné le navigateur d’une personne, sans scripts, avec le texte de chaque image ajouté à son texte alternatif, celui que les WCAG demandent pour une image de texte. rendering.score est la part des éléments que la copie contient dans son texte : ce que reçoit un agent IA à qui l’on sert la copie, sans ouvrir aucune image. rendering.read les compte et reading.items[].rendering marque chaque élément ; la copie elle-même ne fait pas partie du résultat. La page OLIVE YOUNG ci-dessus contient ses 55 éléments dans sa copie, soit un score de 100 : le texte de ses images d’ingrédients et de FAQ en texte alternatif, et les prix et notes que ses scripts chargent.

{
  "screenshot": { "status": "ok", "url": "https://api.querying.ai/v1/evidence/1792627200-0f1e….jpg", "expiresAt": "2026-11-21T04:05:43.048Z" },
  "rendering": {
    "score": 100,
    "read": 55
  }
}

rendering est absent quand aucun navigateur n’a pu afficher la page ou que son HTML dessiné est trop volumineux.

Bien lire le score

La recherche ChatGPT travaille sur une copie de la page faite par son robot : le texte du HTML et ce que les scripts en tirent, sans le texte des images ni ce que la page charge après son ouverture. La copie date du dernier passage du robot, donc une modification n’atteint la recherche ChatGPT qu’une fois la page récupérée à nouveau.
Quand ChatGPT ouvre lui-même une page, il lit le HTML envoyé par le serveur. Il n’exécute aucun script, lit le texte alternatif des images et n’ouvre une image que par le src du img que donne ce HTML. OpenAI réutilise une page qu’il a ouverte pendant environ 30 minutes.
Le score ne bouge que si la page ou sa façon de s’afficher change. Sur quinze pages notées trois fois chacune, dix ont varié de 3 points ou moins. Une page qui affiche des parties différentes à chaque visite varie davantage.
GEO Score mesure ce que ChatGPT a d’une page. Les pages que la recherche ChatGPT choisit pour une question sont suivies par les moniteurs GEO.

Erreurs et facturation

Une tâche terminée coûte 10 crédits pour la page et 5 pour chaque image dont le texte est lu, jusqu’à 12 images : images.read dans le résultat. Une image refusée par l’hôte ou illisible (images.unread) est gratuite. Si votre compte a lu la même image au cours des 90 derniers jours, cette lecture est réutilisée (images.reused) pour 2 crédits. La soumission réserve 70 crédits, le maximum d’une page, et la fin de la tâche facture ce qu’elle a utilisé. Une tâche échouée n’est pas facturée. Voir Crédits et limites.

Refus à la soumission

Statut	Code	Cause
`400`	`VALIDATION_ERROR`	Le corps n’est pas un objet JSON, contient un champ autre que ceux ci-dessus, ou `idempotencyKey`, `priority` ou `webhook` a un mauvais type.
`400`	`USE_DEDICATED_ENDPOINT`	`GEO_SCORE` a été envoyé à `/v1/async/task`.
`402`	`INSUFFICIENT_CREDITS`	Le solde est inférieur à 70 crédits, le maximum d’une page.
`409`	`RESOURCE_ALREADY_EXISTS`	Une tâche avec cet `idempotencyKey` existe déjà.
`422`	`VALIDATION_ERROR`	`url` manque, n’est pas `http` ou `https`, ou désigne un hôte ou un port privé. `details` nomme le champ.
`422`	`REGION_UNSUPPORTED`	`country` n’est ni `US` ni `KR`.

Les erreurs d’authentification, de concurrence et de débit sont les mêmes que pour toute tâche. Voir Erreurs.

Tâches échouées

Une tâche échouée a status: "FAILED" et une chaîne error qui commence par son code :

{
  "success": true,
  "task": { "id": "0b6c1f7e-...", "taskType": "GEO_SCORE", "status": "FAILED", "...": "..." },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 },
  "error": "PAGE_UNAVAILABLE: No browser could show the page (bot wall)"
}

Code	Signification	Que faire
`PAGE_UNAVAILABLE`	Aucun navigateur n’a pu afficher la page telle qu’une personne la voit ou telle que la copie le robot de la recherche ChatGPT : contrôle anti-robot, statut d’erreur ou page inexistante. Le message en donne la raison.	Vérifiez que l’URL s’ouvre dans un navigateur. La même URL échoue de nouveau de la même façon.
`CHATGPT_UNAVAILABLE`	ChatGPT n’a répondu à temps à aucune demande d’ouvrir la page.	Renvoyez la tâche.
`NO_IP_AVAILABLE`	Aucune capacité n’était disponible à temps.	Réessayez plus tard.
Tout autre code	La page n’a pas pu être notée.	Réessayez.

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

GEO Score : mesurer ce que la recherche ChatGPT garde d'une page

Noter une page

Champs de la requête

Comment une page est notée

Lire le résultat

`score`

`direct`

`access`

`reading.items[]`

`analysis`

`markdown`

`screenshot`

`rendering`

Bien lire le score

Erreurs et facturation

Refus à la soumission

Tâches échouées

Étapes suivantes

Citation Analysis

Moniteurs GEO

​Noter une page

​Champs de la requête

​Comment une page est notée

​Lire le résultat

​score

​direct

​access

​reading.items[]

​analysis

​markdown

​screenshot

​rendering

​Bien lire le score

​Erreurs et facturation

​Refus à la soumission

​Tâches échouées

​Étapes suivantes

Citation Analysis

Moniteurs GEO

Noter une page

Champs de la requête

Comment une page est notée

Lire le résultat

`score`

`direct`

`access`

`reading.items[]`

`analysis`

`markdown`

`screenshot`

`rendering`

Bien lire le score

Erreurs et facturation

Refus à la soumission

Tâches échouées

Étapes suivantes