> ## 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/usage
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/usage:
    parameters:
      - name: hours
        in: query
        description: The window in hours.
        schema:
          type: integer
          enum:
            - 24
            - 168
            - 720
          default: 168
    get:
      tags:
        - AI Rendering
      summary: Get AI Rendering usage
      description: >-
        The account's AI Rendering over the window: its sites and pages now, the
        renders and checks that ended in the window with the credits they were
        charged, and the same counts for each site with its reference. Renders
        of pages that were taken down since are not counted.
      operationId: getAiRenderingUsage
      responses:
        '200':
          description: The account's usage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiRenderingUsageResponse'
              example:
                success: true
                usage:
                  windowHours: 720
                  since: '2026-10-15T01:00:00.000Z'
                  sites: 1
                  pages: 1200
                  renders:
                    completed: 1180
                    failed: 12
                    creditsCharged: 14260
                  checks:
                    completed: 3
                    failed: 0
                    creditsCharged: 195
                  creditsCharged: 14455
                  bySite:
                    - siteId: 5b0e9f52-6a3c-4f0e-8d0b-2c7e4a1f9d33
                      host: www.example.com
                      reference: customer-481
                      pages:
                        total: 1200
                        ready: 1150
                        rendering: 40
                        failed: 4
                        expired: 6
                      renders:
                        completed: 1180
                        failed: 12
                        creditsCharged: 14260
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: 'VALIDATION_ERROR: hours is not 24, 168 or 720.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    AiRenderingUsageResponse:
      type: object
      required:
        - success
        - usage
      properties:
        success:
          type: boolean
        usage:
          type: object
          required:
            - windowHours
            - since
            - sites
            - pages
            - renders
            - checks
            - creditsCharged
            - bySite
          properties:
            windowHours:
              type: integer
            since:
              type: string
              format: date-time
            sites:
              type: integer
            pages:
              type: integer
            renders:
              type: object
              required:
                - completed
                - failed
                - creditsCharged
              description: >-
                Renders that ended in the window and the credits they were
                charged.
              properties:
                completed:
                  type: integer
                failed:
                  type: integer
                creditsCharged:
                  type: number
            checks:
              type: object
              required:
                - completed
                - failed
                - creditsCharged
              description: >-
                Checks that ended in the window and the credits they were
                charged.
              properties:
                completed:
                  type: integer
                failed:
                  type: integer
                creditsCharged:
                  type: number
            creditsCharged:
              type: number
              description: Credits the renders and checks were charged.
            bySite:
              type: array
              items:
                type: object
                required:
                  - siteId
                  - host
                  - reference
                  - pages
                  - renders
                properties:
                  siteId:
                    type: string
                  host:
                    type: string
                  reference:
                    type:
                      - string
                      - 'null'
                  pages:
                    type: object
                    required:
                      - total
                      - ready
                      - rendering
                      - failed
                      - expired
                    description: The site's pages now, by status.
                    properties:
                      total:
                        type: integer
                      ready:
                        type: integer
                      rendering:
                        type: integer
                      failed:
                        type: integer
                      expired:
                        type: integer
                  renders:
                    type: object
                    required:
                      - completed
                      - failed
                      - creditsCharged
                    description: >-
                      Renders that ended in the window and the credits they were
                      charged.
                    properties:
                      completed:
                        type: integer
                      failed:
                        type: integer
                      creditsCharged:
                        type: number
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          $ref: '#/components/schemas/ErrorDetail'
    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
  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.