{
  "openapi": "3.1.0",
  "info": {
    "title": "BLOMEGA Public Data API",
    "version": "1.1.0",
    "description": "Read-only, unauthenticated JSON endpoints describing BLOMEGA and its off-the-shelf AI training data catalog. Intended for AI agents, crawlers, and integrators. CORS is open to any origin. For an orientation in prose see https://blomega.com/llms.txt, for the full written corpus in one request see https://blomega.com/llms-full.txt. Licensing, dataset delivery and custom data operations are contracted: pm@blomega.com.",
    "contact": {
      "name": "BLOMEGA",
      "email": "pm@blomega.com",
      "url": "https://blomega.com/"
    }
  },
  "servers": [
    {
      "url": "https://blomega.com"
    }
  ],
  "paths": {
    "/api/company/facts.json": {
      "get": {
        "operationId": "getCompanyFacts",
        "summary": "Source-of-truth facts about BLOMEGA",
        "description": "Company identity, positioning, services, and data-provenance guarantees as structured JSON.",
        "responses": {
          "200": {
            "description": "Company facts",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/datasets.json": {
      "get": {
        "operationId": "getDatasetCatalog",
        "summary": "Off-the-shelf dataset catalog",
        "description": "Machine-readable schema.org DataCatalog of BLOMEGA's off-the-shelf AI training datasets, with categories and representative datasets.",
        "responses": {
          "200": {
            "description": "Dataset catalog (schema.org DataCatalog)",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/feed.json": {
      "get": {
        "operationId": "getUpdatesFeed",
        "summary": "Updates feed (JSON Feed 1.1)",
        "description": "Recent updates to the catalog, provenance framework, and platform.",
        "responses": {
          "200": {
            "description": "JSON Feed",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/company/facts.schema.json": {
      "get": {
        "operationId": "getCompanyFactsSchema",
        "summary": "JSON Schema for the company facts document",
        "description": "Draft 2020-12 schema describing the shape of /api/company/facts.json, so a consumer can validate it instead of inferring its structure.",
        "responses": {
          "200": {
            "description": "JSON Schema for the company facts document",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/status.json": {
      "get": {
        "operationId": "getStatus",
        "summary": "Service status",
        "description": "Health of the public data endpoints.",
        "responses": {
          "200": {
            "description": "Service status",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemap",
        "summary": "Sitemap",
        "description": "Every public URL with its last-modified date.",
        "responses": {
          "200": {
            "description": "Sitemap",
            "content": {
              "application/xml": {}
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "LLM-oriented site map",
        "description": "Plain-text orientation for language models: what BLOMEGA is, the key facts, and every public page with a one-line description.",
        "responses": {
          "200": {
            "description": "LLM-oriented site map",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullTxt",
        "summary": "Full text of every article",
        "description": "The complete written corpus in one request: every research note, guide and comparison as plain text, each with its URL and dates.",
        "responses": {
          "200": {
            "description": "Full text of every article",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    },
    "/rss.xml": {
      "get": {
        "operationId": "getRss",
        "summary": "Updates feed (RSS 2.0)",
        "description": "The same items as /feed.json, as RSS.",
        "responses": {
          "200": {
            "description": "Updates feed (RSS 2.0)",
            "content": {
              "application/rss+xml": {}
            }
          }
        }
      }
    }
  }
}
