Sehen Sie, wie viel ChatGPT von Ihrer Seite liest

Senden Sie eine Seiten-URL an GEO Score und erhalten Sie den Anteil der Seite, den ChatGPT Search hat, was ChatGPT beim Öffnen der Seite erhält, und für jeden fehlenden Teil den Grund und die Lösung.

Was Sie erhalten

• POST /v1/geo-score: Eine Aufgabe bewertet eine Seite. Senden Sie ihre url und das country des Lesers, US oder KR.
• score: der Anteil dessen, was ein Mensch auf der Seite liest, einschließlich Text in Bildern, den ChatGPT Search hat, von 0 bis 100. direct gibt denselben Anteil für das, was ChatGPT erhält, wenn es die Seite selbst öffnet.
• reading.items: jeder Teil der Seite, wo er steht und warum ChatGPT Search ihn verpasst: blocked, javascript_only, structured_data_only oder image_only.
• analysis: die Probleme nach abgezogenen Punkten sortiert, jeweils mit Ursache und Lösung, und potential, der Score nach Behebung der bestätigten Probleme.
• markdown und screenshot: die Seite, wie ein Mensch sie sieht, mit jedem fehlenden Teil an seiner Stelle markiert. rendering gibt den Anteil, den eine für KI-Agenten gerenderte Kopie enthielte.
• Im Dashboard zeigt der GEO-Score-Tab im Playground die Ansicht für Menschen neben der Ansicht für Bots.

So funktioniert es

GEO Score liest robots.txt für OAI-SearchBot, ChatGPT-User und GPTBot und ruft die Seite als jeder von ihnen und als Browser ab. Ein Browser in country rendert die Seite, scrollt bis zum Ende und liest den Text in ihren großen Bildern. Zeilen zum Thema der Seite werden zu Teilen; Menüs, Fußzeilen, andere Produkte, Bewertungen, Schaltflächen und Werbung zählen nicht zum Score.

Die Kopie von ChatGPT Search ist die Seite, als OAI-SearchBot von einer US-Adresse gerendert: der Text des HTML und das, was Skripte daraus zeichnen, ohne Text in Bildern und ohne Inhalte, die die Seite nach dem Öffnen lädt. direct liest das HTML, das ChatGPT-User erhält, so wie der Reader von ChatGPT, und das produktive ChatGPT wird zweimal gebeten, die Seite zu öffnen, um zu sehen, ob es das kann.

Code ordnet jeden Teil zu, daher erhält eine unveränderte Seite denselben Score. Von 15 Seiten, die je dreimal bewertet wurden, bewegten sich 10 um 3 Punkte oder weniger.

Einsatzbereiche

• Bewerten Sie eine Produkt- oder Landingpage vor dem Start und beheben Sie, was ChatGPT nicht sieht, etwa per Skript geladene Preise oder Angaben, die nur in Bildern stehen.
• Bewerten Sie neben Ihrer Seite die Seite eines Wettbewerbers, die ChatGPT in Ihrer Kategorie zitiert.
• Geben Sie die Lösungen aus analysis an Ihr Webteam und bewerten Sie die Seite erneut, sobald die Änderung live ist.
• Prüfen Sie, ob Ihre Website ChatGPT abweist: access.verdict und blockedBy zeigen, wer das Öffnen der Seite verhindert.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.

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

Felder der Anfrage

urlstringPflicht

Die zu bewertende Seite: eine http- oder https-URL auf einem öffentlichen Host mit Standardport, bis zu 2.048 Zeichen.

countrystring

Wo der Leser ist: US (Standard) oder KR. Die Seite wird von einer Adresse in diesem Land geöffnet, in seiner Sprache und Zeitzone.

webhook.urlstring

Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

idempotencyKeystring

Ihre eigene ID für die Anfrage. Jeder Schlüssel erzeugt pro Konto genau eine Aufgabe, ein wiederholter Versand bleibt also eine Aufgabe.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

{
  "success": true,
  "task": {
    "id": "bcb7e1a2-26eb-422f-9f60-31a5e39ee400",
    "taskType": "GEO_SCORE",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T00:02:42.974Z"
  },
  "credits": { "creditsToCharge": 60, "creditsCharged": 60 },
  "response": {
    "url": "https://global.oliveyoung.com/product/detail?prdtNo=GA240322874",
    "pageType": "product",
    "score": 29,
    "direct": { "score": 29, "read": 16 },
    "rendering": { "score": 100, "read": 55 },
    "access": {
      "verdict": "open",
      "chatgpt": { "opened": true, "lines": 819 }
    },
    "reading": {
      "facts": 55,
      "read": 16,
      "locations": { "html": 16, "rendered_only": 13, "image": 26 },
      "items": [
        {
          "label": "COSRX Vitamin E Vitalizing Sunscreen SPF 50+",
          "where": "html",
          "status": "read"
        },
        {
          "label": "US$16.80",
          "where": "rendered_only",
          "status": "missing",
          "reason": "javascript_only"
        },
        {
          "label": "Key Ingredients",
          "where": "image",
          "status": "missing",
          "reason": "image_only"
        },
        "…"
      ]
    },
    "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,
      "issues": [
        {
          "code": "image_only",
          "points": 47,
          "title": "26 facts are written only inside an image",
          "fix": "Write this content as text in the page's HTML, next to the image or in place of it …"
        },
        {
          "code": "javascript_only",
          "points": 24,
          "title": "13 facts are loaded only after the page opens",
          "…": "…"
        }
      ]
    },
    "images": { "read": 10, "reused": 0, "unread": 0 },
    "markdown": "…",
    "screenshot": { "status": "ok", "url": "…", "expiresAt": "…" }
  }
}

task.statusstring

QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.

credits.creditsChargedinteger

Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.

response.scorenumber

Der Anteil dessen, was ein Mensch auf der Seite liest, einschließlich Text in Bildern, den ChatGPT Search in seiner Kopie der Seite hat, von 0 bis 100. Er ist 0, wenn robots.txt oder die Website den Crawler von ChatGPT Search aussperrt.

response.directobject

Was ChatGPT erhält, wenn es die Seite selbst öffnet, etwa wenn jemand die URL nennt: score und die Zahl der Teile in read. Der Score ist 0, wenn ChatGPT die Seite nicht öffnen konnte.

response.renderingobject

Der Anteil der Teile, den eine für KI-Agenten gerenderte Kopie der Seite als Text enthält: das vom Browser gezeichnete HTML ohne Skripte, mit dem Text jedes Bildes im Alt-Text.

response.reading.itemsarray

Ein Eintrag pro Teil der Seite: label, where er steht (html, rendered_only, image und weitere), status read oder missing und der reason, warum ChatGPT Search ihn verpasst: blocked, javascript_only, structured_data_only oder image_only.

response.analysisobject

summary, potential (der Score nach Behebung der bestätigten Probleme) und issues, sortiert nach abgezogenen Punkten, jeweils mit Ursache (detail), fix und den betroffenen Teilen. Der Text ist auf Englisch.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

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

Fehler

VALIDATION_ERRORHTTP 422

url fehlt, ist nicht http oder https oder nennt einen privaten Host oder Port. details nennt das Feld.

USE_DEDICATED_ENDPOINTHTTP 400

GEO_SCORE wurde an /v1/async/task gesendet. Senden Sie es an /v1/geo-score.

REGION_UNSUPPORTEDHTTP 422

country ist weder US noch KR.

MISSING_API_KEYHTTP 401

Der Header Authorization fehlt, oder sein Schlüssel ist unbekannt, abgelaufen oder widerrufen.

INSUFFICIENT_CREDITSHTTP 402

Das Guthaben liegt unter 70 Credits, dem Höchstpreis einer Seite. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.

Preis

Ein abgeschlossener Score kostet 10 Credits für die Seite und 5 für jedes Bild, dessen Text gelesen wird, höchstens 12 Bilder. Ein Bild, das Ihr Konto in den letzten 90 Tagen gelesen hat, kostet 2, und ein Bild, das nicht gelesen werden konnte, ist kostenlos. Beim Senden werden 70 Credits reserviert, der Höchstpreis einer Seite, und beim Abschluss wird berechnet, was die Aufgabe verbraucht hat.

Eine fehlgeschlagene Aufgabe wird nicht berechnet. Wenn kein Browser die Seite anzeigen kann, schlägt die Aufgabe mit PAGE_UNAVAILABLE und dem Grund fehl.