## About
      This is the LLMs Endpoint for the Official website of the Irish
      Building Stock Observatory (IBSO) Version 2.2.0.
      This website (IBSO.ie) is managed by the IBSO (a research group based in Technological University Dublin) to monitor and
      observe the state of buildings across the nation of Ireland
      (residential or commercial) regarding, construction, renovations,
      energy performance, and related metrics. This serves as a resource for policymakers,
      researchers, and the public to understand building stock trends and
      inform decisions on energy efficiency and sustainability.

      ## keywords:
      ["ireland", "irish build stock observatory", "buildings", "construction", "residential",
      "energy rating", "heat pumps", "heat-pumps", "retrofit", "renovations", "decarbonization",
      "de-carbonization", "carbon", "emissions", "fossil fuel"],

      ## Purpose
      The purpose of this endpoint is to provide information about the IBSO website,
      its technical stack, and how to access its data programmatically.
      This is a Next.js 15 application.

      ## Quick Links
      - Website: https://ibso.ie
      - Data & Insight Summary: https://ibso.ie/summary
      - Data API Endpoint: https://ibso.ie/api/data
      - Research Outputs & Publications: https://ibso.ie/findings/
      - Data Validation Methodology: https://ibso.ie/data-validation/

      ## Technical Stack
      - Next.js 15 with App Router
      - React Server Components

      ## Content Updates
      The content on this website is updated quarterly to ensure the latest data and insights
      on the Irish building stock are available to users.

      ## API for Data Access
      - Endpoint: /api/data
      - Query params: ?years=X&stat=Y
      - years: Number of years to retrieve data for (default: 1)
      - stat: Specific statistic to retrieve (options: 'berrating', 'retrofit', 'heating', 'dwelling')
      - If stat is not provided, all statistics are returned.
      - Example: /api/data?years=2&stat=heating
      
      The API returns data in JSON format contianing four main data arrays (one for each stat type, queryable via the 'stat' param):
      1. "berrating" - dwelling counts by BER (Building Energy Rating: A1-G)
      2. "dwelling" - dwelling counts by typology
      3. "heating" - dwelling counts by heating system type
      4. "retrofit" - dwelling counts by retrofit status

      Each array contains quarterly time-series data (YQ format: "YYYY (QX)") broken down by:
      - Location: 'all', 'rural', 'urban'
      - Retrofit Type: 'all', 'retrofitted_dwellings', 'new_builds', 'requiring_retrofit'
      - Dwelling Typology: 'all', 'detached', 'semi_detached', 'terrace', 'mid_terrace', 'end_terrace', 'apartment', 'top_apartment', 'mid_apartment', 'ground_apartment', 'unspecified_apartment', 'other'
      - Heating Type: 'all', 'electricity', 'heatpump', 'oil', 'gas', 'solidfuel', 'others'

      ## Data Validation and Quality
      The data provided through this endpoint undergoes rigorous validation and quality checks
      to ensure accuracy and reliability reaches Eurostat validation level 3.
      For more information on data quality procedures, please refer to the documentation available at:
      - https://ibso.ie/data-validation/

      ## Contact
      For more information or inquiries, please contact the IBSO team at "ciara.ahern@tudublin.ie".
      For technical support, reach out to "elihu.essienthompson@tudublin.ie".