{
  "openapi": "3.1.0",
  "info": {
    "title": "Verified Supplement Data API",
    "description": "Evidence-based supplement recommendations with clinical evidence, cost-per-dose analysis, form quality classification, and medication interaction checking. For AI assistant integration.",
    "version": "1.0.0",
    "contact": {
      "url": "https://verifiedsupplementdata.com"
    }
  },
  "servers": [
    {
      "url": "https://verifiedsupplementdata.com"
    }
  ],
  "paths": {
    "/api/v1/recommend/{supplement}/{condition}.json": {
      "get": {
        "operationId": "getRecommendation",
        "summary": "Get supplement recommendation for a condition",
        "description": "Returns ranked product recommendations with clinical evidence, dosing, cost-per-dose, and purchase links for a specific supplement and condition.",
        "parameters": [
          {
            "name": "supplement",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "magnesium",
                "vitamin-d",
                "omega-3",
                "creatine",
                "iron",
                "vitamin-b12",
                "coq10",
                "collagen",
                "multivitamin",
                "protein"
              ]
            },
            "description": "The supplement category"
          },
          {
            "name": "condition",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Health condition (e.g., sleep, anxiety, deficiency, cardiovascular, strength) or \"all\" for all conditions"
          }
        ],
        "responses": {
          "200": {
            "description": "Supplement recommendation with products",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/recommend/interactions.json": {
      "get": {
        "operationId": "checkInteractions",
        "summary": "Check medication-nutrient interactions",
        "description": "Returns which medications deplete which nutrients, with mechanisms, severity, and recommended supplements.",
        "responses": {
          "200": {
            "description": "Medication interaction data",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/classify/index.json": {
      "get": {
        "operationId": "getFormClassifier",
        "summary": "Get supplement form quality classifier data",
        "description": "Returns detection keywords and quality verdicts for all supplement forms. Use to classify any product by matching its name/ingredients against detection keywords.",
        "responses": {
          "200": {
            "description": "Form classifier data with detection keywords and verdicts",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/recommend/index.json": {
      "get": {
        "operationId": "listSupplements",
        "summary": "List all available supplements and conditions",
        "description": "Returns index of all supplement categories and their available condition endpoints.",
        "responses": {
          "200": {
            "description": "API index",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    }
  }
}