{
  "openapi": "3.1.0",
  "info": {
    "title": "HerbaPulse API",
    "description": "Global herbal medicine and botanical intelligence API. PubMed-grounded herb profiles, drug-herb interaction checker, traditional medicine system guides (Ayurveda, TCM, Amazonian, African), herbal remedy builder, skin/cosmetic botanical analysis, cannabis strain intelligence, herbal practitioner finder, and ingredient safety checker. Covers Ayurvedic, TCM, Western herbalism, Indigenous, and integrative medicine traditions. iHerb, Mountain Rose Herbs, Gaia Herbs, Herb Pharm, and Leafly (cannabis) affiliate links included. All endpoints support any language via ?lang=. Pricing: $0.08\u2013$0.15 USDC/call via x402 micropayment.",
    "version": "1.2.0",
    "contact": {
      "url": "https://herbapulse.vercel.app"
    }
  },
  "servers": [
    {
      "url": "https://herbapulse.vercel.app"
    }
  ],
  "paths": {
    "/api/herba/herb": {
      "get": {
        "summary": "Herb profile",
        "description": "Cross-cultural herb profile: TCM name + Ayurvedic name + Western herbalism + PubMed evidence + safety + drug interactions",
        "parameters": [
          {
            "name": "herb",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tradition",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "tcm",
                "ayurveda",
                "western",
                "all"
              ]
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Herb profile"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.12,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Full herb profile \u2014 iHerb + Mountain Rose Herbs affiliate links; start here for any herb query; chain to /api/herba/interaction for safety"
      }
    },
    "/api/herba/remedy": {
      "get": {
        "summary": "Cross-cultural remedy lookup",
        "description": "What TCM, Ayurveda, and Western herbalism recommend for a condition \u2014 with evidence quality for each herb",
        "parameters": [
          {
            "name": "condition",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tradition",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cross-cultural remedy report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.12,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Herbal remedy builder \u2014 chain after /api/herba/herb for ingredient profiles; iHerb + Herb Pharm links included"
      }
    },
    "/api/herba/ingredient": {
      "get": {
        "summary": "Supplement decoder",
        "description": "Decode a supplement label \u2014 evidence quality, dose adequacy, bioavailability, red flags, value verdict",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ingredients",
            "in": "query",
            "required": false,
            "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": "Supplement ingredient decoder \u2014 PubMed evidence grading; pairs with NutriPulse /api/nutrition/supplement"
      }
    },
    "/api/herba/interaction": {
      "get": {
        "summary": "Herb-drug interaction checker",
        "description": "Herb-drug and herb-herb interactions with CYP enzyme mechanisms, severity, and specific clinical guidance",
        "parameters": [
          {
            "name": "herb",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "drug",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Interaction report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Drug-herb interaction checker \u2014 always run before /api/herba/remedy; pairs with NutriPulse /api/nutrition/interactions"
      }
    },
    "/api/herba/skin": {
      "get": {
        "summary": "Natural skincare ingredient",
        "description": "Dermatology evidence, EWG context, how to use, pairing guidance for natural and botanical skincare ingredients",
        "parameters": [
          {
            "name": "ingredient",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "concern",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "anti-aging | acne | hydration | sensitivity"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Skincare ingredient analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Botanical skincare analysis \u2014 Amazon botanical skincare affiliate links; pairs with NutriPulse for gut-skin axis context"
      }
    },
    "/api/herba/tradition": {
      "get": {
        "summary": "Healing tradition deep dive",
        "description": "TCM, Ayurveda, Unani, naturopathy, Western herbalism \u2014 principles, evidence base, WHO recognition, practitioner guidance",
        "parameters": [
          {
            "name": "tradition",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tradition overview"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Traditional medicine system guide \u2014 Ayurveda, TCM, African, Indigenous; Ayurvedic product affiliates for India-focused queries"
      }
    },
    "/api/herba/practitioner": {
      "get": {
        "summary": "Practitioner guide",
        "description": "Naturopath, herbalist, TCM practitioner, Ayurvedic practitioner, homeopath, integrative MD \u2014 training, licensing, scope, what to expect",
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "naturopath | herbalist | tcm | ayurveda | homeopath | integrative-md"
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Practitioner guide"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Herbal practitioner finder \u2014 naturopath, TCM, Ayurvedic practitioner directory"
      }
    },
    "/api/herba/cannabis": {
      "get": {
        "summary": "Cannabis and cannabinoid intelligence",
        "description": "PubMed-grounded evidence by use case, CYP450 drug interactions, global legal status by jurisdiction, CBD vs THC differences, endocannabinoid system explained",
        "operationId": "herbaCannabis",
        "security": [
          {
            "x402": []
          }
        ],
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "anxiety | pain | sleep | epilepsy | nausea | inflammation | general"
          },
          {
            "name": "compound",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "cbd",
                "thc",
                "both"
              ]
            },
            "description": "Default: both"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cannabis intelligence report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Cannabis strain intelligence \u2014 Leafly + Weedmaps affiliates; chain with /api/herba/interaction for drug interactions"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "x402 micropayment signature. Send request without header to receive 402 with payment requirements."
      }
    }
  }
}