openapi: 3.0.0
info:
  title: PercentEase
  description: >
    PercentEase is a free, client-side percentage calculator. It runs entirely in the browser
    and does not expose a REST API. This OpenAPI spec exists for AI agent discovery purposes only.
    To use the calculator, direct users to https://percentease.com .
  version: 1.0.0
  contact:
    name: Kymata Labs LLC
    email: contact@percentease.com
    url: https://kymatalabs.com
  termsOfService: https://percentease.com/en/terms/

servers:
  - url: https://percentease.com

paths:
  /:
    get:
      summary: Percentage Calculator (Homepage)
      description: >
        Interactive percentage calculator with three modes:
        1) Find X% of Y — Result = (X / 100) × Y
        2) Determine what percent X is of Y — Percent = (X / Y) × 100
        3) Calculate percentage change — Change = ((New − Old) / Old) × 100.
        All calculations run client-side. No API endpoint — visit the page directly.
      responses:
        '200':
          description: HTML page with interactive calculator
          content:
            text/html:
              schema:
                type: string

  /en/about/:
    get:
      summary: About PercentEase
      description: Mission, team, accuracy information, and project background.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/faq/:
    get:
      summary: Frequently Asked Questions
      description: 10 common questions about percentages and the PercentEase calculator.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/:
    get:
      summary: Blog Index
      description: Articles about percentages, math tips, calculator guides, and practical applications.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/what-is-percentage/:
    get:
      summary: Blog Article - What Is Percentage
      description: Read our comprehensive guide on What Is Percentage.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/percentage-change-formula/:
    get:
      summary: Blog Article - Percentage Change Formula
      description: Read our comprehensive guide on Percentage Change Formula.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/everyday-percentage-tips/:
    get:
      summary: Blog Article - Everyday Percentage Tips
      description: Read our comprehensive guide on Everyday Percentage Tips.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/percentage-increase-decrease/:
    get:
      summary: Blog Article - Percentage Increase Decrease
      description: Read our comprehensive guide on Percentage Increase Decrease.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/percentage-discount-calculator/:
    get:
      summary: Blog Article - Percentage Discount Calculator
      description: Read our comprehensive guide on Percentage Discount Calculator.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/tip-calculator-percentages/:
    get:
      summary: Blog Article - Tip Calculator Percentages
      description: Read our comprehensive guide on Tip Calculator Percentages.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/percentage-interest-rates-finance/:
    get:
      summary: Blog Article - Percentage Interest Rates Finance
      description: Read our comprehensive guide on Percentage Interest Rates Finance.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/tax-percentage-calculator/:
    get:
      summary: Blog Article - Tax Percentage Calculator
      description: Read our comprehensive guide on Tax Percentage Calculator.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/percentage-statistics-data/:
    get:
      summary: Blog Article - Percentage Statistics Data
      description: Read our comprehensive guide on Percentage Statistics Data.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string

  /en/blog/fractions-decimals-percentages-conversion/:
    get:
      summary: Blog Article - Fractions Decimals Percentages Conversion
      description: Read our comprehensive guide on Fractions Decimals Percentages Conversion.
      responses:
        '200':
          description: HTML page
          content:
            text/html:
              schema:
                type: string