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

# 진단 조회

> 진단의 단계와 결과를 읽습니다.



## OpenAPI

````yaml GET /v1/ai-rendering/checks/{id}
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/{id}:
    parameters:
      - name: id
        in: path
        required: true
        description: The check's id.
        schema:
          type: string
    get:
      tags:
        - AI Rendering
      summary: Get a check
      description: >-
        Returns the check with its stage. The result fields are present once
        stage is completed, and error once it is failed. The id of any GEO Score
        task of the account reads as a check; one scored without answers has no
        questions.
      operationId: getAiRenderingCheck
      responses:
        '200':
          description: The check.
          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: completed
                  createdAt: '2026-11-14T01:00:00.000Z'
                  completedAt: '2026-11-14T01:00:52.000Z'
                  creditsCharged: 75
                  headline:
                    facts: 48
                    readNow: 21
                    readWithCopy: 46
                    measured: true
                  unread:
                    image_only: 14
                    javascript_only: 9
                    unanswered: 4
                  access:
                    verdict: open
                  screenshot:
                    url: >-
                      https://api.querying.ai/v1/evidence/1794667978-0f1e2d3c4b5a69788796a5b4c3d2e1f0.jpg
                    expiresAt: '2026-12-14T01:00:40.000Z'
                    width: 1366
                    height: 3600
                    regions:
                      - top: 1466
                        left: 8
                        width: 924
                        height: 2134
                        facts: 14
                        reason: image_only
                  questions:
                    - question: 충전재의 종류와 솜털·깃털 비율은 어떻게 되나요?
                      truth: 충전재 - 덕 다운 (솜털 80%, 깃털 20%)
                      reason: image_only
                      now:
                        answer: '충전재의 종류와 솜털·깃털 비율: 페이지에 기재되어 있지 않습니다.'
                        correct: false
                      withCopy:
                        answer: 충전재는 덕다운(오리털)이며, 솜털 80%, 깃털 20%입니다.
                        correct: true
                  copy:
                    url: >-
                      https://api.querying.ai/v1/evidence/1794667978-bc983041ef4b485592879369e0fa80ed.html
                    expiresAt: '2026-12-14T01:00:40.000Z'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: 'NOT_FOUND: no check of the account with that id.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    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.