> ## 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.

# 诊断页面

> 查看 ChatGPT 目前能读到页面的多少内容，以及通过 AI Rendering 副本能读到多少。



## OpenAPI

````yaml POST /v1/ai-rendering/checks
openapi: 3.1.0
info:
  title: querying.ai
  description: >-
    One API for every AI answer engine. Every task is asynchronous: submit, then
    collect the result via webhook or polling.
  version: 1.0.0
servers:
  - url: https://api.querying.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/ai-rendering/checks:
    post:
      tags:
        - AI Rendering
      summary: Check a page
      description: >-
        Queues a check of one page: how much of what a person reads on it
        ChatGPT search keeps now, how much the AI Rendering copy of the page
        holds, and what ChatGPT answers to the same questions when it opens the
        page and when it opens the copy. A check is a GEO Score with answers: it
        costs what that GEO Score costs, holds 75 credits when it starts, and
        its id is a GEO Score task id that POST
        /v1/ai-rendering/sites/{id}/pages publishes by taskId. Poll GET
        /v1/ai-rendering/checks/{id}; a check takes about a minute.
      operationId: createAiRenderingCheck
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiRenderingCheckRequest'
            example:
              url: https://www.example.com/products/down-jacket
              country: KR
      responses:
        '202':
          description: Queued.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiRenderingCheckResponse'
              example:
                success: true
                check:
                  id: 0b6c1f7e-2d4a-4c55-9a0e-3f1d2b7c8e91
                  url: https://www.example.com/products/down-jacket
                  country: KR
                  stage: queued
                  createdAt: '2026-11-14T01:00:00.000Z'
                  completedAt: null
                  creditsCharged: 0
        '400':
          description: >-
            VALIDATION_ERROR: the body is not a JSON object, has a field other
            than url, country, idempotencyKey and webhook, or one of the last
            two has the wrong type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: 'INSUFFICIENT_CREDITS: the balance cannot cover the 75-credit hold.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            KEY_SCOPE_DENIED: the API key is limited to engines that leave out
            GEO_SCORE.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: >-
            RESOURCE_ALREADY_EXISTS: a check with this idempotencyKey already
            exists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: >-
            VALIDATION_ERROR: url is missing, is not http or https, or names a
            private host or port. REGION_UNSUPPORTED: country is not US or KR.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: >-
            The account's task queue is full, or the key used up its daily
            credit limit. Retry after Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: The engine's backlog is full; retry after Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    AiRenderingCheckRequest:
      type: object
      required:
        - url
      additionalProperties: false
      properties:
        url:
          type: string
          format: uri
          maxLength: 2048
          description: >-
            The page to check: an http or https URL on a public host, on the
            default port.
        country:
          type: string
          enum:
            - US
            - KR
          default: US
          description: >-
            Where the person reading the page is. Use the country of the site
            the page will be published to.
        idempotencyKey:
          type: string
          description: >-
            Optional. Deduplicates submissions for at least 30 days after the
            request; a duplicate is a 409.
        webhook:
          type: object
          description: >-
            Optional. Receives the GEO Score task when it reaches a terminal
            state.
          required:
            - url
          properties:
            url:
              type: string
              format: uri
    AiRenderingCheckResponse:
      type: object
      required:
        - success
        - check
      properties:
        success:
          type: boolean
        check:
          $ref: '#/components/schemas/AiRenderingCheck'
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          $ref: '#/components/schemas/ErrorDetail'
    AiRenderingCheck:
      type: object
      required:
        - id
        - url
        - country
        - stage
        - createdAt
        - completedAt
        - creditsCharged
      properties:
        id:
          type: string
          description: The check's id, which is its GEO Score task id.
        url:
          type: string
          format: uri
        country:
          type: string
          enum:
            - US
            - KR
        stage:
          type: string
          enum:
            - queued
            - reading_page
            - asking_chatgpt
            - completed
            - failed
          description: >-
            queued: waiting to start. reading_page: the page is rendered as a
            person and as ChatGPT's crawler sees it, and the text of its images
            is read. asking_chatgpt: ChatGPT is answering the questions.
            completed: the result fields are present. failed: error says why; a
            failed check is not charged.
        createdAt:
          type: string
          format: date-time
        completedAt:
          type:
            - string
            - 'null'
          format: date-time
        creditsCharged:
          type: number
          description: Credits the check was charged. 0 until it ends.
        headline:
          type: object
          required:
            - facts
            - readNow
            - readWithCopy
            - measured
          description: The check in three numbers.
          properties:
            facts:
              type: integer
              description: Pieces a person reads on the page that ChatGPT was asked about.
            readNow:
              type: integer
              description: Pieces ChatGPT answered correctly when it opened the page.
            readWithCopy:
              type:
                - integer
                - 'null'
              description: >-
                Pieces ChatGPT answered correctly when it opened the copy
                rendered for AI agents. null when no copy could be made.
            measured:
              type: boolean
              description: true when the numbers come from ChatGPT's answers.
        unread:
          type: object
          description: >-
            The pieces ChatGPT missed, counted by reason. A reason with no piece
            is absent.
          additionalProperties: false
          properties:
            blocked:
              type: integer
            javascript_only:
              type: integer
            structured_data_only:
              type: integer
            image_only:
              type: integer
            unanswered:
              type: integer
        access:
          type:
            - object
            - 'null'
          description: >-
            Whether ChatGPT can reach the page: the access object of
            GeoScoreResult.
        screenshot:
          type:
            - object
            - 'null'
          required:
            - url
            - expiresAt
          description: >-
            The first four screens of the page as a person sees it, as a JPEG,
            with the images whose text ChatGPT search does not keep placed on
            it. Its url opens the file without an API key until expiresAt. null
            when the picture could not be taken or stored.
          properties:
            url:
              type: string
              format: uri
            expiresAt:
              type: string
              format: date-time
            width:
              type: integer
              description: The picture's width in CSS pixels, the unit of regions.
            height:
              type: integer
              description: The picture's height in CSS pixels.
            regions:
              type: array
              description: >-
                Where the picture shows an image whose text ChatGPT search does
                not keep, from top to bottom. An image below the picture or
                inside an iframe has no region.
              items:
                type: object
                required:
                  - top
                  - left
                  - width
                  - height
                  - facts
                  - reason
                properties:
                  top:
                    type: integer
                  left:
                    type: integer
                  width:
                    type: integer
                  height:
                    type: integer
                  facts:
                    type: integer
                    description: Pieces written only inside the image shown there.
                  reason:
                    type: string
                    const: image_only
        questions:
          type: array
          maxItems: 6
          description: >-
            The same questions asked of ChatGPT twice: opening the page, and
            opening its copy. See GeoScoreAnswers.
          items:
            type: object
            required:
              - question
              - truth
              - now
            properties:
              question:
                type: string
                description: >-
                  A question a person would ask about the page, in the page's
                  language, that one piece of the page answers.
              truth:
                type: string
                description: The piece of the page that answers it, as a person reads it.
              reason:
                $ref: '#/components/schemas/GeoScoreMeasuredReason'
                description: Why ChatGPT missed the piece. Absent when it answered it.
              now:
                type:
                  - object
                  - 'null'
                required:
                  - answer
                  - correct
                description: >-
                  What ChatGPT answered when asked to open the page. null when
                  ChatGPT gave no reply in time.
                properties:
                  answer:
                    type: string
                    description: >-
                      ChatGPT's answer to the question, quoted from its reply.
                      Empty when the reply skipped the question.
                  correct:
                    type: boolean
                    description: Whether the answer states the same fact as truth.
              withCopy:
                type:
                  - object
                  - 'null'
                required:
                  - answer
                  - correct
                description: >-
                  What ChatGPT answered when asked to open the copy of the page
                  rendered for AI agents. null when ChatGPT gave no reply in
                  time or could not open the copy; absent when the page has no
                  copy.
                properties:
                  answer:
                    type: string
                    description: >-
                      ChatGPT's answer to the question, quoted from its reply.
                      Empty when the reply skipped the question.
                  correct:
                    type: boolean
                    description: Whether the answer states the same fact as truth.
        copy:
          type:
            - object
            - 'null'
          required:
            - url
            - expiresAt
          description: >-
            The copy of the page rendered for AI agents that ChatGPT opened for
            withCopy. Its url opens the file without an API key until expiresAt.
            Publish it to a site with POST /v1/ai-rendering/sites/{id}/pages and
            the check's id as taskId. null when no copy could be made.
          properties:
            url:
              type: string
              format: uri
            expiresAt:
              type: string
              format: date-time
        error:
          type: object
          required:
            - code
            - message
          description: >-
            Why the check failed, with the codes of a failed GEO Score such as
            PAGE_UNAVAILABLE and CHATGPT_UNAVAILABLE.
          properties:
            code:
              type: string
            message:
              type: string
        humanView:
          oneOf:
            - $ref: '#/components/schemas/GeoScoreHumanView'
            - type: 'null'
        aiView:
          oneOf:
            - $ref: '#/components/schemas/GeoScoreAiView'
            - type: 'null'
    ErrorDetail:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Stable, safe to branch on. See the Errors guide for the full list.
        message:
          type: string
          description: For humans. May change.
        details:
          description: >-
            Context for the error. An array of `{field, message}` on most
            `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on
            `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted
            when there is nothing to add.
          oneOf:
            - type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
            - type: object
              additionalProperties: true
        timestamp:
          type: string
          format: date-time
    GeoScoreMeasuredReason:
      type: string
      enum:
        - blocked
        - javascript_only
        - structured_data_only
        - image_only
        - unanswered
      description: >-
        Why ChatGPT missed a piece it was asked about: the crawler's reason from
        GeoScoreMissReason, or unanswered when ChatGPT search's copy holds the
        piece and ChatGPT still did not answer it.
    GeoScoreHumanView:
      type: object
      required:
        - source
        - url
        - title
        - facts
        - images
        - text
      description: >-
        The page as a person sees it: what the score counts as the page's
        content.
      properties:
        source:
          type: string
          enum:
            - web_scrape
            - browser
            - html
          description: >-
            web_scrape: read the way a WEB_SCRAPE task with screenshot: true
            reads it. browser: the check's own browser. html: the HTML, when no
            browser could show the page.
        url:
          type: string
          format: uri
        title:
          type: string
        facts:
          type: integer
          description: The pieces of the page the score asks about.
        images:
          type: object
          properties:
            shown:
              type: integer
            read:
              type: integer
              description: Images whose text was read.
        text:
          type: string
          description: >-
            The page's text as a person reads it, each image's text in its
            place, up to 50,000 characters.
    GeoScoreAiView:
      type: object
      required:
        - measured
        - chatgpt
        - crawlers
      description: >-
        The page as ChatGPT gets it: measured by asking ChatGPT, and the
        crawlers' requests that say why a piece is missed.
      properties:
        measured:
          type: boolean
          description: Whether chatgpt holds measured numbers (answers was set).
        chatgpt:
          type: object
          required:
            - opened
            - inSearch
          properties:
            opened:
              type: boolean
            inSearch:
              type: boolean
            asks:
              type: integer
            facts:
              type: integer
            read:
              type: integer
            readWithCopy:
              type:
                - integer
                - 'null'
            regions:
              type: array
              items:
                type: object
              description: As measured.regions.
        crawlers:
          type: object
          properties:
            searchBot:
              type: object
              description: >-
                OAI-SearchBot: the status, whether it was blocked or refused,
                the pieces its copy holds (read of facts) and the copy's text,
                up to 50,000 characters.
            chatgptUser:
              type: object
              description: >-
                ChatGPT-User: the status, whether it was blocked, and the pieces
                its HTML holds.
            robots:
              type: object
              description: >-
                robots.txt for OAI-SearchBot, ChatGPT-User and GPTBot, as
                access.robots.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key, sent as `Authorization: Bearer <key>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.