AgentDeals Traffic API

openapi: 3.2.0
info:
  title: Agentdeals Dev Traffic API
  version: 0.1.0
  contact:
    name: AgentDeals
    url: https://agentdeals.dev
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  description: 'Operations tagged Traffic across 2 of this provider''s published API definitions: agentdeals-dev.json, agentdeals-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agentdeals.dev
  description: Production server
security: []
tags:
- name: Traffic
paths:
  /api/traffic:
    get:
      summary: Traffic by client class
      description: Our own request counters, split by what made the request — AI agent, crawler or browser — with MCP tool calls alongside web hits so the two can be compared. These are counts of visits to us, not index data, so no citation block is attached. available is false when the store backing the daily series is not configured, and error then says so.
      responses:
        '200':
          description: Traffic counters over several windows
          content:
            application/json:
              schema:
                type: object
                properties:
                  today:
                    $ref: '#/components/schemas/TrafficWindow'
                  last_7d:
                    $ref: '#/components/schemas/TrafficWindow'
                  last_30d:
                    $ref: '#/components/schemas/TrafficWindow'
                  web_vs_mcp:
                    type: object
                    additionalProperties:
                      type: object
                    description: Web hits, AI-agent hits and MCP tool calls per window, with the ratios between them. A ratio is null when the denominator is zero.
                  available:
                    type: boolean
                    description: Whether the daily series has a store behind it. False means only the since-boot counters are meaningful.
                  error:
                    type: string
                    description: Why the daily series is unavailable, when it is.
                  since_boot_by_class:
                    type: object
                    additionalProperties:
                      type: integer
                  since_boot_not_found:
                    type: integer
                  since_boot_redirects:
                    type: integer
                  not_found_sample:
                    type: array
                    items:
                      type: object
                      properties:
                        ts:
                          type: string
                          format: date-time
                        client_class:
                          type: string
                        status:
                          type: integer
                        path:
                          type: string
                  sessions:
                    type: object
                    properties:
                      daily:
                        type: array
                        items:
                          type: object
                      today:
                        type: integer
                      recording_since:
                        type:
                        - string
                        - 'null'
                        format: date
                        description: The first day of the daily series. A count before this date is not missing, it was never recorded.
                      all_time:
                        type: integer
                      retention_days:
                        type: integer
                  ai_agent_trigger_families:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
                    description: Which user agents we read as user-initiated, as search indexing, and as training crawls.
                  notes:
                    type: array
                    items:
                      type: string
                    description: What each figure does and does not count, including how much of it is our own crawling.
                  storage:
                    type: object
                    description: Whether the counters are being persisted, and the failures if not.
                  vendor_series:
                    type: object
                    description: State of the per-vendor daily series.
      tags:
      - Traffic
      operationId: getApiTraffic
      x-operation-id-source: derived
    servers:
    - url: https://agentdeals.dev
      description: Production server
components:
  schemas:
    TrafficWindow:
      type: object
      description: Request counts over one window. `coverage` says how much of the window we hold data for, so a low figure can be read as quiet rather than as unrecorded.
      properties:
        days:
          type: integer
        from:
          type: string
          format: date
        to:
          type: string
          format: date
        detail_days:
          type: integer
        data_days_available:
          type: integer
        coverage:
          type: string
        hits_total:
          type: integer
        hits_excluding_internal:
          type: integer
          description: Hits with our own crawling removed.
        by_class:
          type: object
          additionalProperties:
            type: integer
          description: Hits per client class.
        ai_agent_by_family:
          type: object
          additionalProperties:
            type: integer
        ai_agent_by_trigger:
          type: object
          additionalProperties:
            type: integer
          description: AI-agent hits split by whether a person asked for them.
x-refined-from:
- agentdeals-dev.json
- agentdeals-dev-openapi.json