HoneyLabs Service API

openapi: 3.2.0
info:
  title: HoneyLabs Service API
  version: 1.2.0
  summary: Primary honeypot sensor observations, queryable.
  description: 'HoneyLabs publishes what its own internet-facing honeypot sensors observe. Every record is first-hand.


    **If you are an AI agent, prefer the MCP server** at `https://mcp.honeylabs.net/mcp` (server card: `https://mcp.honeylabs.net/mcp/server-card`). The tools aggregate for you, so one call replaces a client you would otherwise write and maintain.


    **Prefer list endpoints over loops.** `/api/cves` returns every CVE currently being probed in one request; requesting them one id at a time costs far more for both sides and will hit limits quickly.


    Keys are free and issued at once at https://honeylabs.net/dashboard. Plans, prices and limits are in `/pricing.json`; every interface is listed in `/.well-known/api-catalog` (RFC 9727).'
  contact:
    name: HoneyLabs
    url: https://honeylabs.net
  license:
    name: HoneyLabs terms of service
    url: https://honeylabs.net/terms
  termsOfService: https://honeylabs.net/terms
servers:
- url: https://honeylabs.net
security:
- bearerAuth: []
tags:
- name: Service
  description: 'About the service itself: plans and limits.'
paths:
  /pricing.json:
    get:
      tags:
      - Service
      operationId: getPlans
      summary: Plans, prices and limits
      security: []
      description: Every plan with its price (EUR, excluding VAT) and the limits the platform enforces, generated from the same registry the quota checks read. Needs no key and is not metered.
      responses:
        '200':
          description: The plan catalogue
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlanCatalog'
components:
  schemas:
    PlanCatalog:
      type: object
      required:
      - currency
      - prices_include_vat
      - plans
      properties:
        currency:
          type: string
          const: EUR
        prices_include_vat:
          type: boolean
        credit:
          type: string
          description: What one credit buys.
        included_in_every_plan:
          type: array
          items:
            type: string
        plans:
          type: array
          items:
            type: object
            required:
            - id
            - name
            - price
            - limits
            properties:
              id:
                type: string
                enum:
                - free
                - solo
                - pro
                - research
                - team
              name:
                type: string
              summary:
                type: string
              price:
                type: object
                properties:
                  currency:
                    type: string
                  vat_included:
                    type: boolean
                  monthly:
                    type: integer
                  annual:
                    type: integer
                  free:
                    type: boolean
              how_to_get:
                type: object
                properties:
                  method:
                    type: string
                    enum:
                    - sign_up
                    - checkout
                    - application
                    - request
                  url:
                    type: string
                  note:
                    type: string
              limits:
                type: object
                properties:
                  daily_credits:
                    type: integer
                  requests_per_minute:
                    type: integer
                  burst_requests_per_second:
                    type: integer
                  query_window_days:
                    type:
                    - integer
                    - 'null'
                  query_window:
                    type: string
                  full_history:
                    type: boolean
                  enrich_addresses_per_request:
                    type: integer
                  watchlists:
                    type: integer
                  feed_tokens_per_watchlist:
                    type: integer
                  alert_subscriptions:
                    type: integer
                  fastest_alert_cadence_minutes:
                    type: integer
                  fastest_feed_digest:
                    type: string
              support:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Free key from https://honeylabs.net/dashboard
externalDocs:
  description: Docs with worked examples
  url: https://honeylabs.net/docs