> ## Documentation Index
> Fetch the complete documentation index at: https://docs.55-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage metrics

> Per-key usage metrics: request counts, success/fail rates, bytes transferred, protocol breakdown, and top domains.



## OpenAPI

````yaml /zh/scraping-api/openapi.json get /usage
openapi: 3.1.0
info:
  title: 55 Tech Scraping API
  description: >-
    Distributed fetch network. Route HTTP, browser, WebSocket, and AMQP requests
    through 80+ geo-distributed agents with health-aware routing and block
    detection.
  version: 2.2.0
  contact:
    name: 55 Tech Support
    email: contact@55-tech.com
servers:
  - url: https://scraping-api.55-tech.com
    description: Production
security:
  - ApiKeyHeader: []
tags:
  - name: Fetch
    description: Proxy HTTP requests through the agent network.
  - name: Browser
    description: Fetch with full JavaScript rendering, cookies, and screenshots.
  - name: Network
    description: Agent registry, network status, and domain health.
  - name: AMQP
    description: AMQP/RabbitMQ consumer relay via SSE.
  - name: Usage
    description: Per-key usage metrics.
  - name: Debug
    description: Debug and diagnostic endpoints.
  - name: System
    description: Health checks and system endpoints.
paths:
  /usage:
    get:
      tags:
        - Usage
      summary: Usage metrics
      description: >-
        Per-key usage metrics: request counts, success/fail rates, bytes
        transferred, protocol breakdown, and top domains.
      operationId: get_usage
      responses:
        '200':
          description: Usage metrics for the authenticated API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponse'
        '401':
          description: Missing or invalid API key.
        '403':
          description: Invalid API key.
components:
  schemas:
    UsageResponse:
      type: object
      properties:
        api_key:
          type: string
        total:
          type: integer
          description: Total requests across all protocols.
        success:
          type: integer
          description: Successful requests.
        fail:
          type: integer
          description: Failed requests.
        success_rate:
          type: number
          description: Success percentage (0-100).
        bytes_transferred:
          type: integer
          description: Total response bytes (HTTP fetch only).
        rate_limit:
          type: object
          properties:
            rps:
              type: number
              description: Allowed requests per second.
            burst:
              type: integer
              description: Burst capacity.
            remaining:
              type: number
              description: Available tokens now.
        by_protocol:
          type: object
          properties:
            fetch:
              type: integer
            ws:
              type: integer
            amqp:
              type: integer
        top_domains:
          type: array
          items:
            type: object
            properties:
              domain:
                type: string
              requests:
                type: integer
          description: Top 20 domains by request count.
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key passed in the X-API-Key header.

````