desearch-ai Network Stats API

openapi: 3.2.0
info:
  title: Desearch Network Stats API
  description: The Desearch API is a powerful suite of AI-driven tools designed to integrate natural language processing, AI-powered search, image generation, and data extraction into your applications. Whether you’re building intelligent search engines, automating content creation, analyzing text data, or generating AI-based media, Desearch provides a robust and scalable solution.
  version: 1.0.0
servers:
- url: https://api.desearch.ai
security:
- ApiKeyAuth: []
tags:
- name: Network Stats
paths:
  /network/stats:
    get:
      tags:
      - Network Stats
      summary: Get public network stats
      description: Returns the latest public Desearch network counters and their per-second growth rates. The current source is explicitly identified as an estimate. No API key is required.
      operationId: get_network_stats_network_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkStatsResponse'
      security: []
  /network/stats/history:
    get:
      tags:
      - Network Stats
      summary: Get the latest 20 minutes of network stats
      description: Returns a one-second timeline for the latest 20 minutes so clients can hydrate a recent activity buffer before following the live stream. The current source is explicitly identified as an estimate. No API key is required.
      operationId: get_network_stats_history_network_stats_history_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkStatsHistoryResponse'
      security: []
  /network/stats/stream:
    get:
      tags:
      - Network Stats
      summary: Stream live network stats
      description: Streams one server-issued network stats snapshot per second using Server-Sent Events. Each `stats` event carries the same JSON as `/network/stats`. Reconnect with `Last-Event-ID` to replay snapshots missed within the last 20 minutes. No API key is required.
      operationId: get_network_stats_stream_network_stats_stream_get
      responses:
        '200':
          description: Server-Sent Events stream of `stats` events.
          content:
            text/event-stream:
              schema:
                type: string
      security: []
components:
  schemas:
    NetworkStatsHistoryPoint:
      properties:
        total_searchable_pages:
          type: integer
          title: Total Searchable Pages
        searches_completed_today:
          type: integer
          title: Searches Completed Today
        urls_crawled_today:
          type: integer
          title: Urls Crawled Today
        observed_at:
          type: string
          format: date-time
          title: Observed At
        telemetry_kind:
          type: string
          const: estimated
          title: Telemetry Kind
          default: estimated
        methodology:
          type: string
          const: fixed_rate_projection
          title: Methodology
          default: fixed_rate_projection
      type: object
      required:
      - total_searchable_pages
      - searches_completed_today
      - urls_crawled_today
      - observed_at
      title: NetworkStatsHistoryPoint
    NetworkStatsResponse:
      properties:
        total_searchable_pages:
          type: integer
          title: Total Searchable Pages
        searches_completed_today:
          type: integer
          title: Searches Completed Today
        urls_crawled_today:
          type: integer
          title: Urls Crawled Today
        rates_per_second:
          $ref: '#/components/schemas/NetworkStatsRates'
        started_at:
          type: string
          format: date-time
          title: Started At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        telemetry_kind:
          type: string
          const: estimated
          title: Telemetry Kind
          default: estimated
        methodology:
          type: string
          const: fixed_rate_projection
          title: Methodology
          default: fixed_rate_projection
      type: object
      required:
      - total_searchable_pages
      - searches_completed_today
      - urls_crawled_today
      - rates_per_second
      - started_at
      - updated_at
      title: NetworkStatsResponse
    NetworkStatsHistoryResponse:
      properties:
        window_seconds:
          type: integer
          title: Window Seconds
        interval_seconds:
          type: integer
          title: Interval Seconds
        window_started_at:
          type: string
          format: date-time
          title: Window Started At
        window_ended_at:
          type: string
          format: date-time
          title: Window Ended At
        points:
          items:
            $ref: '#/components/schemas/NetworkStatsHistoryPoint'
          type: array
          title: Points
      type: object
      required:
      - window_seconds
      - interval_seconds
      - window_started_at
      - window_ended_at
      - points
      title: NetworkStatsHistoryResponse
    NetworkStatsRates:
      properties:
        total_searchable_pages:
          type: integer
          title: Total Searchable Pages
        searches_completed_today:
          type: integer
          title: Searches Completed Today
        urls_crawled_today:
          type: integer
          title: Urls Crawled Today
      type: object
      required:
      - total_searchable_pages
      - searches_completed_today
      - urls_crawled_today
      title: NetworkStatsRates
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization