{
  "openapi": "3.1.0",
  "info": {
    "title": "ASO Studio — Agent Search Optimization & Live Edge Probe API",
    "version": "2.6.0",
    "description": "Free real-time 47-check B2B SaaS AI search readiness probe (<400ms), empirical 400+ SaaS benchmark dataset, and Pay-$0-Today turnkey Edge Worker / 26-file PR order reservation API.",
    "contact": {
      "name": "Liam Vance — ASO Studio",
      "url": "https://asostudio.dev",
      "email": "liam@asostudio.dev"
    }
  },
  "servers": [
    {
      "url": "https://aso-live-probe.asostudio.workers.dev",
      "description": "Real-time Edge Probe Worker"
    },
    {
      "url": "https://aso-studio-edge.asostudio.workers.dev",
      "description": "Order & Fulfillment Edge Worker"
    },
    {
      "url": "https://asostudio.dev",
      "description": "Canonical Storefront & Open Benchmark Dataset"
    }
  ],
  "paths": {
    "/api/probe": {
      "get": {
        "operationId": "probeDomainAsoScore",
        "summary": "Run a free real-time edge audit on any public B2B SaaS domain",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": { "type": "string", "example": "hono.dev" },
            "description": "Public domain to audit across /robots.txt, /llms.txt, /.well-known/ai.txt, /pricing.md, /ai/summary.json, /.well-known/mcp.json, and Schema.org JSON-LD."
          }
        ],
        "responses": {
          "200": { "description": "Real-time ASO score, endpoint HTTP status matrix, missing machine signals, and starter /llms.txt." }
        }
      }
    },
    "/ai/saas-index.json": {
      "get": {
        "operationId": "getEmpiricalSaasBenchmarkDataset",
        "summary": "Fetch the open 400+ B2B SaaS AI search readiness dataset",
        "responses": {
          "200": { "description": "JSON dataset with summary metrics and per-domain ASO scores and teardown URLs." }
        }
      }
    },
    "/api/orders": {
      "post": {
        "operationId": "createTurnkeyAsoOrder",
        "summary": "Reserve a Pay-$0-Today Edge Worker / 26-file PR deployment or instant USDC/XMR unlock",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["company_name", "domain", "contact_email", "tier_slug", "payment_method"],
                "properties": {
                  "company_name": { "type": "string" },
                  "domain": { "type": "string" },
                  "contact_email": { "type": "string", "format": "email" },
                  "tier_slug": {
                    "type": "string",
                    "enum": ["edge-agent-layer", "foundation-sprint", "category-saturation", "enterprise-som", "agency-whitelabel"]
                  },
                  "payment_method": {
                    "type": "string",
                    "enum": ["invoice_wire", "usdc_erc20", "xmr_subaddress"]
                  },
                  "notes": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Order confirmation receipt with order_ref and settlement/delivery details." }
        }
      }
    }
  }
}