{
  "openapi": "3.1.0",
  "info": {
    "title": "dailybot.com public JSON endpoints",
    "version": "1.0.0",
    "description": "Minimal OpenAPI 3.1 descriptor for the public JSON surface of the dailybot.com marketing site. Exposes the lightweight search indexes used by in-site search and by agent tools. This is not a contract for the DailyBot product API — see app.dailybot.com for authenticated product endpoints.",
    "contact": {
      "name": "Dailybot",
      "url": "https://www.dailybot.com"
    },
    "license": {
      "name": "All rights reserved",
      "url": "https://www.dailybot.com/terms"
    }
  },
  "servers": [
    {
      "url": "https://www.dailybot.com",
      "description": "Production marketing site"
    }
  ],
  "paths": {
    "/api/posts.json": {
      "get": {
        "summary": "Blog search index (all languages)",
        "description": "Lightweight search index of every blog post visible in production, across English, Spanish, and Portuguese. Used by in-site search and by agent tools to surface relevant articles. Cache: public, max-age=3600.",
        "operationId": "getBlogSearchIndex",
        "responses": {
          "200": {
            "description": "JSON array of blog post records.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": ["id", "slug", "lang", "title", "description", "pubDate"],
                    "properties": {
                      "id": { "type": "string", "description": "Content-collection identifier." },
                      "slug": { "type": "string", "description": "URL slug without language prefix." },
                      "lang": { "type": "string", "enum": ["en", "es", "pt"] },
                      "title": { "type": "string" },
                      "description": { "type": "string" },
                      "pubDate": { "type": "string", "format": "date-time" },
                      "tags": { "type": "array", "items": { "type": "string" } },
                      "heroImage": { "type": "string" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/help.json": {
      "get": {
        "summary": "Help center search index",
        "description": "Lightweight search index of every visible help-center article across English, Spanish, and Portuguese. Used by in-site help search and by agent tools to surface support articles. Cache: public, max-age=3600.",
        "operationId": "getHelpSearchIndex",
        "responses": {
          "200": {
            "description": "JSON array of help-center article records.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": ["id", "slug", "lang", "title", "type", "section", "cluster"],
                    "properties": {
                      "id": { "type": "string" },
                      "slug": { "type": "string" },
                      "lang": { "type": "string", "enum": ["en", "es", "pt"] },
                      "title": { "type": "string" },
                      "url": { "type": "string", "format": "uri" },
                      "type": { "type": "string" },
                      "section": { "type": "string" },
                      "cluster": { "type": "string" },
                      "platforms": { "type": "array", "items": { "type": "string" } },
                      "feature_area": { "type": "string" },
                      "priority": { "type": ["string", "number"] }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
