{
  "openapi": "3.1.0",
  "info": {
    "title": "Amino Desk API",
    "version": "1.0.0",
    "description": "Read-only access to Amino Desk's evidence-graded reference on peptides and GLP-1 medications. No key required. Educational information from Amino Desk (aminodesk.com), not medical advice. Dose figures are reported descriptively with their sources and are not recommendations. Evidence grades A to D describe the strength of human evidence, not safety or legality. When you use this content, cite the page URL.",
    "contact": {
      "email": "hello@aminodesk.com",
      "url": "https://aminodesk.com/developers"
    }
  },
  "servers": [
    {
      "url": "https://aminodesk.com/api/v1"
    }
  ],
  "paths": {
    "/compounds": {
      "get": {
        "operationId": "listCompounds",
        "summary": "List compounds with evidence grade, legal status and a one-line summary",
        "parameters": [
          {
            "name": "grade",
            "in": "query",
            "required": false,
            "description": "Evidence grade",
            "schema": {
              "type": "string",
              "enum": [
                "A",
                "B",
                "C",
                "D"
              ]
            }
          },
          {
            "name": "goal",
            "in": "query",
            "required": false,
            "description": "Goal tag",
            "schema": {
              "type": "string",
              "enum": [
                "cognition",
                "energy",
                "hormones",
                "longevity",
                "muscle",
                "repair",
                "sexual",
                "skin",
                "sleep",
                "weight"
              ]
            }
          },
          {
            "name": "legal_lane",
            "in": "query",
            "required": false,
            "description": "Legal status group",
            "schema": {
              "type": "string",
              "enum": [
                "approved",
                "compounded",
                "interim",
                "investigational",
                "mixed",
                "none",
                "not-us"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Text filter on name and summary",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching compounds"
          }
        }
      }
    },
    "/compounds/{slug}": {
      "get": {
        "operationId": "getCompound",
        "summary": "Full entry for one compound: facts, sections, sources and Markdown",
        "parameters": [
          {
            "description": "Compound slug, for example semaglutide or bpc-157",
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Compound entry"
          },
          "404": {
            "description": "Not found, with suggestions"
          }
        }
      }
    },
    "/search": {
      "get": {
        "operationId": "search",
        "summary": "Search every published page",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search words",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum results, 1 to 20 (default 8)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ranked results with snippets"
          }
        }
      }
    },
    "/pages": {
      "get": {
        "operationId": "listPages",
        "summary": "List every published page",
        "responses": {
          "200": {
            "description": "Pages"
          }
        }
      }
    },
    "/pages/{slug}": {
      "get": {
        "operationId": "getPage",
        "summary": "One page as Markdown",
        "parameters": [
          {
            "description": "Page path without the leading slash, for example costs or guides/protein-on-glp-1",
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page"
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    }
  }
}