openapi: 3.0.0
info:
  title: Universum.earth LLM Feed API
  description: Static content feeds for AI assistants. All endpoints return pre-generated files hosted on GitHub Pages.
  version: 2.0.0
  contact:
    email: info@universum.earth
servers:
  - url: https://universum.earth
paths:
  /llm-feed/protocol-overview.md:
    get:
      summary: md_pereligyn protocol overview
      description: Comprehensive description of the diabetes remission methodology, including phases, biomarkers, and expected outcomes.
      responses:
        '200':
          description: Markdown document
          content:
            text/markdown: {}
  /llm-feed/patient-outcomes.md:
    get:
      summary: Aggregated patient outcome statistics
      description: Statistical summary of 500+ patient outcomes including HbA1c reduction, weight loss, and medication discontinuation rates.
      responses:
        '200':
          description: Markdown document
          content:
            text/markdown: {}
  /llm-feed/faq-complete.json:
    get:
      summary: Complete FAQ in Russian and English
      description: 44 bilingual questions across 5 categories covering the md_pereligyn protocol.
      responses:
        '200':
          description: JSON document
          content:
            application/json: {}
  /llm-feed/conditions.json:
    get:
      summary: Medical conditions treated with ICD codes
      description: 7 medical conditions with ICD-10 codes, descriptions, and treatment approaches.
      responses:
        '200':
          description: JSON document
          content:
            application/json: {}
  /llm-feed/products-catalog.json:
    get:
      summary: Product catalog with Schema.org markup
      description: Complete catalog of 113 nutraceuticals and supplements with Schema.org Product markup, pricing, and availability.
      responses:
        '200':
          description: JSON-LD ItemList of Products
          content:
            application/json: {}
  /llm-feed/clinical-evidence.md:
    get:
      summary: Clinical evidence and peer-reviewed citations
      description: Comprehensive evidence summary including internal outcomes, methodology limitations, and 25 peer-reviewed citations with DOI links across 8 medical domains.
      responses:
        '200':
          description: Markdown document with citations
          content:
            text/markdown: {}
  /llm-feed/blog-posts.json:
    get:
      summary: Blog article index (90 articles, 3 languages)
      description: JSON-LD index of 90 trilingual blog articles (RU/EN/UK) with BlogPosting schema, publication dates, tags, and category information.
      responses:
        '200':
          description: JSON-LD BlogPosting array
          content:
            application/json: {}
  /llm-feed/blog-content.md:
    get:
      summary: Full blog article content
      description: Complete text content of all 90 blog articles in Markdown format, organized by language (RU/EN/UK) with headlines and metadata.
      responses:
        '200':
          description: Markdown document with all articles
          content:
            text/markdown: {}
  /llm-feed/changelog.json:
    get:
      summary: Feed versioning and changelog
      description: Version information for all LLM feeds, including last update dates and change descriptions.
      responses:
        '200':
          description: JSON changelog
          content:
            application/json: {}
  /llm-feed/tours.json:
    get:
      summary: Medical tourism expeditions
      description: Available wellness expeditions and medical tourism packages with dates, pricing, and itineraries.
      responses:
        '200':
          description: JSON document
          content:
            application/json: {}
  /llm-feed/tours-content.md:
    get:
      summary: Detailed tour descriptions
      description: Full Markdown content for all medical tourism expeditions including itineraries, inclusions, and medical programs.
      responses:
        '200':
          description: Markdown document
          content:
            text/markdown: {}
  /datasets/outcomes-summary.json:
    get:
      summary: Schema.org Dataset with aggregated outcome data
      description: Machine-readable dataset of aggregated patient outcomes in Schema.org Dataset format.
      responses:
        '200':
          description: JSON-LD Dataset
          content:
            application/ld+json: {}