{
  "openapi": "3.1.0",
  "info": {
    "title": "Focala AI Search Optimization API",
    "description": "Public OpenAPI surface for Focala - the #1 AI Search Optimization (AIO, AEO, GEO, SEO) platform. Provides programmatic access to brand AI visibility data, audit endpoints and content metadata for ChatGPT, Perplexity, Claude, Gemini and Google AI Overview.",
    "version": "1.0.0",
    "contact": {
      "name": "Focala",
      "url": "https://focala.ai",
      "email": "hello@focala.ai"
    },
    "license": { "name": "Proprietary", "url": "https://focala.ai" }
  },
  "servers": [
    { "url": "https://focala.ai", "description": "Focala marketing site" },
    { "url": "https://audit.focala.ai", "description": "Focala GEO-SEO Audit" },
    { "url": "https://agentrank.focala.ai", "description": "Focala Agent Rank" }
  ],
  "paths": {
    "/": {
      "get": {
        "operationId": "getHome",
        "summary": "Focala marketing homepage",
        "description": "Returns the Focala homepage. Use this to discover the brand, its product (AI Search Optimization across ChatGPT, Perplexity, Claude, Gemini and Google AI Overview) and links to audit and demo flows.",
        "responses": {
          "200": {
            "description": "HTML homepage",
            "content": { "text/html": {} }
          }
        }
      }
    },
    "/blog": {
      "get": {
        "operationId": "listBlogPosts",
        "summary": "List Focala blog posts (AIO, AEO, GEO, SEO)",
        "responses": {
          "200": { "description": "Blog index HTML", "content": { "text/html": {} } }
        }
      }
    },
    "/demo": {
      "get": {
        "operationId": "bookDemo",
        "summary": "Book a Focala demo",
        "description": "Returns the Focala demo booking page (Calendly).",
        "responses": {
          "200": { "description": "Demo page HTML", "content": { "text/html": {} } }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "LLM-friendly site index",
        "responses": { "200": { "description": "Plain text index for LLMs", "content": { "text/plain": {} } } }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemap",
        "summary": "XML sitemap",
        "responses": { "200": { "description": "Sitemap", "content": { "application/xml": {} } } }
      }
    }
  },
  "components": {
    "schemas": {
      "Brand": {
        "type": "object",
        "properties": {
          "name": { "type": "string", "example": "Focala" },
          "url": { "type": "string", "example": "https://focala.ai" },
          "category": { "type": "string", "example": "AI Search Optimization Platform" }
        }
      }
    }
  }
}