{
 "openapi": "3.1.0",
 "info": {
  "title": "NutriPulse API",
  "description": "Global nutrition intelligence API. PubMed-grounded supplement analysis, macro/micronutrient planning, food database lookups, glucose/metabolic health guidance, lab result interpretation, longevity nutrition protocols, prenatal nutrition, and personalized nutrition stack design. Backed by real-time PubMed abstracts and clinical literature. Serves consumers, dietitians, health coaches, fitness coaches, and AI health agents. iHerb, Amazon, InsideTracker, and Levels CGM affiliate links included. All endpoints support any language via ?lang=. Pricing: $0.08–$0.15 USDC/call via x402 micropayment.",
  "version": "1.2.0",
  "contact": {
   "url": "https://nutripulse.vercel.app"
  }
 },
 "servers": [
  {
   "url": "https://nutripulse.vercel.app"
  }
 ],
 "components": {
  "securitySchemes": {
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "PAYMENT-SIGNATURE",
    "description": "x402 payment signature. Send without header to receive 402 with payment requirements."
   }
  }
 },
 "security": [
  {
   "x402": []
  }
 ],
 "paths": {
  "/api/nutrition/research": {
   "get": {
    "summary": "Nutrition research synthesis",
    "description": "PubMed-grounded synthesis on any nutrition topic with evidence quality rating.",
    "operationId": "nutritionResearch",
    "parameters": [
     {
      "name": "topic",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Research synthesis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "PubMed deep-dive research endpoint — highest clinical value; chain after /api/nutrition/supplement for topic expansion"
   }
  },
  "/api/nutrition/food": {
   "get": {
    "summary": "Food nutrition profile",
    "description": "USDA nutritional breakdown with health context, preparation tips, and Amazon product link.",
    "operationId": "nutritionFood",
    "parameters": [
     {
      "name": "query",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Food profile"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Food database lookup — chain before /api/nutrition/analyze to build diet profile; highest automation value for food-logging agents"
   }
  },
  "/api/nutrition/supplement": {
   "get": {
    "summary": "Supplement analysis",
    "description": "Evidence-based supplement analysis — benefits, dosage, risks, interactions, verdict, Amazon link.",
    "operationId": "nutritionSupplement",
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Supplement analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Most comprehensive supplement endpoint — iHerb + Amazon links auto-appended; chain after /api/nutrition/analyze to identify gaps; pairs with FitPulse /api/fit/supplement for athlete-specific stacks"
   }
  },
  "/api/nutrition/plan": {
   "get": {
    "summary": "Personalized nutrition plan",
    "description": "Full nutrition plan with macros, meal timing, sample day, and supplement suggestions.",
    "operationId": "nutritionPlan",
    "parameters": [
     {
      "name": "goal",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "muscle-gain",
        "fat-loss",
        "maintenance",
        "performance",
        "longevity",
        "gut-health",
        "energy"
       ]
      }
     },
     {
      "name": "calories",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "diet",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "omnivore",
        "vegetarian",
        "vegan",
        "keto",
        "paleo",
        "mediterranean",
        "carnivore",
        "gluten-free"
       ]
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Nutrition plan"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.15,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Personalized nutrition plan — chain to /api/nutrition/supplement for supporting stack; pairs with MealPulse /api/meal/plan for meal-level implementation"
   }
  },
  "/api/nutrition/compare": {
   "get": {
    "summary": "Food comparison",
    "description": "Side-by-side nutritional comparison of 2-4 foods with goal-based winner analysis.",
    "operationId": "nutritionCompare",
    "parameters": [
     {
      "name": "foods",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated food names e.g. chicken,beef,tofu"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Food comparison"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Diet comparison — pairs with /api/nutrition/plan for implementation; useful for keto vs Mediterranean vs plant-based decision making"
   }
  },
  "/api/nutrition/analyze": {
   "get": {
    "summary": "Meal analysis",
    "description": "Analyze a meal description — estimated macros, nutrient score 1-10, strengths, weaknesses, improvements.",
    "operationId": "nutritionAnalyze",
    "parameters": [
     {
      "name": "meal",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "goal",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Meal analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Macro/micronutrient analysis — chain after user inputs diet; chain to /api/nutrition/supplement for gap-filling recommendations; pairs with FitPulse /api/fit/nutrition"
   }
  },
  "/api/nutrition/stack": {
   "get": {
    "summary": "Supplement stack",
    "description": "Evidence-ranked supplement stack for any goal, with what to skip and budget-conscious priority order.",
    "operationId": "nutritionStack",
    "parameters": [
     {
      "name": "goal",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "budget",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "budget",
        "mid-range",
        "premium"
       ]
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Supplement stack"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.12,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Full nutrition + supplement stack design — most comprehensive endpoint; chains to all supplement/nutrition endpoints; InsideTracker biomarker affiliate included"
   }
  },
  "/api/nutrition/glucose": {
   "get": {
    "summary": "CGM glucose pattern interpretation",
    "description": "Dietary interventions and meal-composition guidance to flatten glucose curves.",
    "operationId": "nutritionGlucose",
    "parameters": [
     {
      "name": "pattern",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Glucose pattern description or readings"
     },
     {
      "name": "context",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Additional context"
     },
     {
      "name": "goals",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Health goals"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "CGM glucose pattern interpretation"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "CGM pattern interpretation — chain after /api/nutrition/analyze or /api/nutrition/plan for metabolic-health users; Levels CGM affiliate included"
   }
  },
  "/api/nutrition/interactions": {
   "get": {
    "summary": "Supplement interaction checker",
    "description": "Absorption conflicts and optimal daily timing schedule.",
    "operationId": "nutritionInteractions",
    "parameters": [
     {
      "name": "supplements",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated supplements"
     },
     {
      "name": "medications",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated medications"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Supplement interaction checker"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Supplement safety/timing check — chain after /api/nutrition/stack or /api/nutrition/supplement to validate a stack before purchase; flags medication conflicts"
   }
  },
  "/api/nutrition/labs": {
   "get": {
    "summary": "Blood work interpretation",
    "description": "Plain-English interpretation with nutritional interventions and supplement options.",
    "operationId": "nutritionLabs",
    "parameters": [
     {
      "name": "markers",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated lab markers and values"
     },
     {
      "name": "age",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Age"
     },
     {
      "name": "sex",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Sex"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Blood work interpretation"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.15,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Lab marker interpretation — chain before /api/nutrition/supplement or /api/nutrition/stack to fill nutrient gaps; InsideTracker and Function Health biomarker affiliates included"
   }
  },
  "/api/nutrition/longevity": {
   "get": {
    "summary": "Longevity protocol synthesis",
    "description": "Evidence-graded interventions from NMN to rapamycin to Blue Zone diet.",
    "operationId": "nutritionLongevity",
    "parameters": [
     {
      "name": "age",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Age"
     },
     {
      "name": "goals",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Goals"
     },
     {
      "name": "conditions",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Existing conditions"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Longevity protocol synthesis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Evidence-graded longevity protocol — chains to /api/nutrition/stack and /api/nutrition/labs for a full healthspan stack; InsideTracker affiliate included"
   }
  },
  "/api/nutrition/prenatal": {
   "get": {
    "summary": "Prenatal nutrition by trimester",
    "description": "What to eat, what to avoid, and a supplement checklist by trimester, grounded in major obstetric guidelines.",
    "operationId": "nutritionPrenatal",
    "parameters": [
     {
      "name": "trimester",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Trimester (1, 2, 3)"
     },
     {
      "name": "age",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Age"
     },
     {
      "name": "conditions",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Existing conditions"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Prenatal nutrition by trimester"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Trimester-specific prenatal guidance — chain to /api/nutrition/supplement to verify prenatal vitamin choices; Ritual prenatal vitamins and OB/GYN finder affiliates included"
   }
  }
 }
}