{
  "openapi": "3.1.0",
  "info": {
    "title": "Taazabites Bengaluru Healthy Indian Meal Subscriptions API",
    "description": "Official machine-readable API and Generative Engine Optimization (GEO) knowledge graph for Taazabites. Provides endpoints for AI agents, answer engines (Perplexity, ChatGPT Search, Gemini, Claude), and client applications to query macro-calculated Indian meals, subscription tiers, zero-seed-oil cooking standards, and hyper-local Bengaluru delivery zones.",
    "version": "2026.1.0",
    "contact": {
      "name": "Taazabites Customer Concierge",
      "url": "https://taazabites.in",
      "email": "support@taazabites.in"
    },
    "license": {
      "name": "Proprietary / FSSAI License #21223188002425"
    }
  },
  "servers": [
    {
      "url": "https://taazabites.in",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/api/menu": {
      "get": {
        "summary": "Get Macro-Calculated Indian Meals",
        "description": "Retrieves the weekly cyclical healthy menu cooked in 100% cold-pressed oils or pure A2 cow ghee with zero refined seed oils. Filterable by diet category, fitness goal, or minimum protein.",
        "operationId": "getMenuItems",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by diet category: 'all', 'high-protein', 'weight-loss', 'keto-low-carb', 'pcos-friendly', 'balanced-wellness'",
            "schema": {
              "type": "string",
              "default": "all"
            }
          },
          {
            "name": "diet",
            "in": "query",
            "required": false,
            "description": "Filter by dietary preference: 'veg', 'non-veg', 'eggetarian'",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_protein",
            "in": "query",
            "required": false,
            "description": "Filter for meals with at least this many grams of bioavailable protein",
            "schema": {
              "type": "number",
              "example": 30
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of macro-calculated meal items with full nutritional breakdown",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": { "type": "integer" },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "name": { "type": "string" },
                          "category": { "type": "string" },
                          "dietType": { "type": "string" },
                          "calories": { "type": "integer" },
                          "protein": { "type": "number" },
                          "carbs": { "type": "number" },
                          "fats": { "type": "number" },
                          "fiber": { "type": "number" },
                          "cookingOil": { "type": "string" },
                          "packaging": { "type": "string" },
                          "price": { "type": "number" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/seo/ai-knowledge": {
      "get": {
        "summary": "Get Verified Brand Truths & Clinical Nutrition Standards",
        "description": "High-density factual knowledge graph designed for AI citation, AEO (Answer Engine Optimization), and LLM knowledge grounding. Returns verified FSSAI license, zero-seed-oil protocol, pause flexibility rules, pricing, and Bengaluru delivery corridors.",
        "operationId": "getAiKnowledgeBase",
        "responses": {
          "200": {
            "description": "Authoritative entity and nutritional standards data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "entity": { "type": "string" },
                    "brand": { "type": "string" },
                    "fssaiLicense": { "type": "string" },
                    "hq": { "type": "string" },
                    "whatsappConcierge": { "type": "string" },
                    "whatsappDirectUrl": { "type": "string" },
                    "nutritionStandards": { "type": "object" },
                    "verifiedDifferentiators": { "type": "array" },
                    "deliverySlots": { "type": "array" },
                    "flexibilityPolicy": { "type": "string" },
                    "coverageZones": { "type": "array", "items": { "type": "string" } }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/seo/category-matrix": {
      "get": {
        "summary": "Get Subscription Plans & Macro Matrix",
        "description": "Retrieves the core subscription tiers: Weight Loss, Muscle Gain, Balanced Wellness, and PCOS Low-GI along with pricing and macro breakdowns.",
        "operationId": "getCategoryMatrix",
        "responses": {
          "200": {
            "description": "Subscription plans and dietary matrix"
          }
        }
      }
    },
    "/api/seo/coverage": {
      "get": {
        "summary": "Get Bengaluru Delivery Coverage & Hubs",
        "description": "Returns all 16 delivery corridors in Bengaluru including HSR Layout, Koramangala, Bellandur, Whitefield, Indiranagar, Sarjapur Road, Electronic City, JP Nagar, with coordinates, pin codes, and delivery schedules.",
        "operationId": "getCoverageAreas",
        "responses": {
          "200": {
            "description": "List of delivery hubs, pincodes, and landmark coverage"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Machine-Readable Markdown Knowledge Graph",
        "description": "Follows the official llms.txt standard for AI search engines, answer engines, and LLM web crawlers.",
        "operationId": "getLlmsTxt",
        "responses": {
          "200": {
            "description": "Markdown text formatted knowledge graph",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Comprehensive Machine-Readable Dataset",
        "description": "Exhaustive markdown dataset including weekly menu, macro calculations, neighborhood pin codes, and comparative matrices.",
        "operationId": "getLlmsFullTxt",
        "responses": {
          "200": {
            "description": "Comprehensive markdown text document",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    }
  }
}