{
  "openapi": "3.0.0",
  "info": {
    "title": "GLP1 Launch API",
    "description": "AI-accessible API for GLP-1, supplement-interaction, and peptide/longevity research briefs. Free question indexes and $0.01 premium briefs paid via x402 on Base mainnet. Premium answers cite named sources with links. trending_score is an editorial priority score, not live trend data.",
    "version": "1.1.0",
    "contact": {
      "name": "GLP1 Launch API Support",
      "url": "https://github.com/chilies4114/GLP1LAUNCH"
    }
  },
  "servers": [
    {
      "url": "https://glp1launch-1.onrender.com",
      "description": "Production server"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "Health Check",
        "operationId": "healthCheck",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "message": {
                      "type": "string"
                    },
                    "openapi": {
                      "type": "string"
                    },
                    "ai_info": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/stats": {
      "get": {
        "summary": "Aggregate Usage Stats (Free)",
        "description": "Aggregate request counts per endpoint and paid unlocks. Privacy-safe: no health queries, wallet addresses, IPs, or user agents are collected. In-memory; resets on redeploy.",
        "operationId": "getStats",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "since": {
                      "type": "string"
                    },
                    "total_requests": {
                      "type": "integer"
                    },
                    "paid_unlocks": {
                      "type": "integer"
                    },
                    "by_endpoint": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "integer"
                      }
                    },
                    "privacy_note": {
                      "type": "string"
                    },
                    "resets_note": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/glp1/top-questions": {
      "get": {
        "summary": "Get Trending GLP-1 Questions (Free)",
        "description": "Top trending GLP-1 medication questions with basic information. No payment required.",
        "operationId": "GetTrendingGLP-1Questions",
        "tags": [
          "GLP-1",
          "Free",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/supplements/interactions": {
      "get": {
        "summary": "Get Trending Supplement Interaction Questions (Free)",
        "description": "Top supplement & vitamin interaction questions with basic information. No payment required.",
        "operationId": "GetTrendingSupplementInteractionQuestions",
        "tags": [
          "Supplements",
          "Free",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/peptides/longevity": {
      "get": {
        "summary": "Get Trending Peptide & Longevity Questions (Free)",
        "description": "Top peptide & longevity questions with basic information. No payment required.",
        "operationId": "GetTrendingPeptide&LongevityQuestions",
        "tags": [
          "Peptides",
          "Free",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/glp1/top-questions-paid": {
      "get": {
        "summary": "Get Premium GLP-1 Research Briefs (Paid)",
        "description": "Premium GLP-1 medication briefs with detailed answers, cited sources with links, dosing schedules, side-effect management, cost strategies, and a drug comparison table. Payment: $0.01 USDC on Base mainnet via the x402 protocol (HTTP 402 + PAYMENT-SIGNATURE).",
        "operationId": "GetPremiumGLP-1ResearchBriefs",
        "tags": [
          "GLP-1",
          "Paid",
          "x402",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "last_updated": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          },
                          "detailed_answer": {
                            "type": "string"
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                }
                              },
                              "required": [
                                "name",
                                "url"
                              ]
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required - x402 payment instructions are returned in the PAYMENT-REQUIRED header"
          }
        }
      }
    },
    "/supplements/interactions-paid": {
      "get": {
        "summary": "Get Premium Supplement Interaction Briefs (Paid)",
        "description": "Premium supplement & vitamin interaction briefs: absorption, timing, and drug-interaction flags with cited sources with links, plus a pairing guide. Payment: $0.01 USDC on Base mainnet via the x402 protocol (HTTP 402 + PAYMENT-SIGNATURE).",
        "operationId": "GetPremiumSupplementInteractionBriefs",
        "tags": [
          "Supplements",
          "Paid",
          "x402",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "last_updated": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          },
                          "detailed_answer": {
                            "type": "string"
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                }
                              },
                              "required": [
                                "name",
                                "url"
                              ]
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required - x402 payment instructions are returned in the PAYMENT-REQUIRED header"
          }
        }
      }
    },
    "/peptides/longevity-paid": {
      "get": {
        "summary": "Get Premium Peptide & Longevity Briefs (Paid)",
        "description": "Premium peptide & longevity briefs: FDA/legal status, evidence levels, and safety flags with cited sources with links, plus a compound reference table. Payment: $0.01 USDC on Base mainnet via the x402 protocol (HTTP 402 + PAYMENT-SIGNATURE).",
        "operationId": "GetPremiumPeptide&LongevityBriefs",
        "tags": [
          "Peptides",
          "Paid",
          "x402",
          "Health"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "last_updated": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "scoring": {
                      "type": "object",
                      "properties": {
                        "trending_score": {
                          "type": "string",
                          "example": "Editorial priority score (0-100) assigned by the site maintainers to rank question importance. It is not derived from live trend or traffic data."
                        }
                      }
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "question": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "trending_score": {
                            "type": "integer",
                            "description": "Editorial priority score 0-100; not derived from live trend data"
                          },
                          "detailed_answer": {
                            "type": "string"
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                }
                              },
                              "required": [
                                "name",
                                "url"
                              ]
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required - x402 payment instructions are returned in the PAYMENT-REQUIRED header"
          }
        }
      }
    }
  }
}
