openapi: 3.0.3
info:
  title: Denver I Love - Jennifer Dechtman Real Estate API
  description: |
    API for accessing Denver real estate information, neighborhood data, and agent contact.
    
    This API provides information about:
    - Denver neighborhoods (Cherry Creek, Hilltop, Lowry, Crestmoor, Central Park, Cherry Hills)
    - Real estate market data and pricing
    - Home buying and selling services
    - Agent contact information
    
    For human users, visit https://denverilove.com
    For AI content, see /llms.txt and /llms-full.txt
  version: "1.0.0"
  contact:
    name: Jennifer Dechtman
    email: jenn@denverilove.com
    url: https://denverilove.com
  license:
    name: Proprietary
    url: https://denverilove.com
servers:
  - url: https://denverilove.com
    description: Production server
paths:
  /:
    get:
      summary: Homepage
      description: Main landing page with overview of Jennifer Dechtman's real estate services in Denver
      operationId: getHomepage
      tags:
        - Pages
      responses:
        '200':
          description: HTML page with real estate agent information
  /llms.txt:
    get:
      summary: AI Content Summary
      description: Concise summary of website content optimized for LLMs and AI search engines
      operationId: getLlmsSummary
      tags:
        - AI Content
      responses:
        '200':
          description: Plain text summary of website content
          content:
            text/plain:
              schema:
                type: string
  /llms-full.txt:
    get:
      summary: Comprehensive AI Content
      description: Full detailed content about Denver real estate, neighborhoods, and services for AI agents
      operationId: getLlmsFull
      tags:
        - AI Content
      responses:
        '200':
          description: Comprehensive plain text content
          content:
            text/plain:
              schema:
                type: string
  /insights:
    get:
      summary: Market Insights Blog
      description: Blog posts about Denver real estate market, neighborhood guides, and buying/selling tips
      operationId: getInsights
      tags:
        - Pages
      responses:
        '200':
          description: HTML blog page
  /faq:
    get:
      summary: Frequently Asked Questions
      description: Comprehensive FAQ about Denver real estate, buying, selling, and neighborhoods
      operationId: getFaq
      tags:
        - Pages
      responses:
        '200':
          description: HTML FAQ page
  /compare-neighborhoods:
    get:
      summary: Neighborhood Comparison Tool
      description: Interactive tool to compare Denver neighborhoods by price, schools, amenities, and lifestyle
      operationId: getNeighborhoodComparison
      tags:
        - Tools
      responses:
        '200':
          description: HTML comparison tool page
  /neighborhoods/cherry-creek:
    get:
      summary: Cherry Creek Neighborhood Guide
      description: |
        Detailed guide to Cherry Creek neighborhood including:
        - Median home price: $1.6M
        - Luxury shopping and dining
        - Walk score: 85
        - Best for luxury buyers and urban convenience seekers
      operationId: getCherryCreek
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
  /neighborhoods/hilltop:
    get:
      summary: Hilltop Neighborhood Guide
      description: |
        Detailed guide to Hilltop neighborhood including:
        - Median home price: $1.4M
        - Historic Tudor and Colonial homes
        - Mountain views and tree-lined streets
        - Best for families and historic home enthusiasts
      operationId: getHilltop
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
  /neighborhoods/lowry:
    get:
      summary: Lowry Neighborhood Guide
      description: |
        Detailed guide to Lowry neighborhood including:
        - Median home price: $750K
        - Master-planned community on former air base
        - 800+ acres of parks
        - Best for families and young professionals
      operationId: getLowry
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
  /neighborhoods/crestmoor:
    get:
      summary: Crestmoor Neighborhood Guide
      description: |
        Detailed guide to Crestmoor neighborhood including:
        - Median home price: $1.3M
        - Excellent schools (Bromwell Elementary)
        - Family-friendly atmosphere
        - Best for families prioritizing education
      operationId: getCrestmoor
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
  /neighborhoods/central-park:
    get:
      summary: Central Park (Stapleton) Neighborhood Guide
      description: |
        Detailed guide to Central Park neighborhood including:
        - Median home price: $650K
        - 80+ parks and new construction
        - Denver's largest urban development
        - Best for families seeking modern homes
      operationId: getCentralPark
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
  /neighborhoods/cherry-hills:
    get:
      summary: Cherry Hills Village & Greenwood Village Guide
      description: |
        Detailed guide to Cherry Hills and Greenwood Village including:
        - Median home price: $2.5M
        - Exclusive estates and country clubs
        - Top-rated Cherry Creek Schools
        - Best for ultra-luxury buyers
      operationId: getCherryHills
      tags:
        - Neighborhoods
      responses:
        '200':
          description: HTML neighborhood page
components:
  schemas:
    Neighborhood:
      type: object
      properties:
        name:
          type: string
          example: "Cherry Creek"
        slug:
          type: string
          example: "cherry-creek"
        medianHomePrice:
          type: integer
          example: 1600000
        priceRange:
          type: object
          properties:
            min:
              type: integer
            max:
              type: integer
        walkScore:
          type: integer
          example: 85
        schoolRating:
          type: integer
          example: 8
        description:
          type: string
    Agent:
      type: object
      properties:
        name:
          type: string
          example: "Jennifer Dechtman"
        title:
          type: string
          example: "Real Estate Agent"
        brokerage:
          type: string
          example: "Sotheby's International Realty"
        phone:
          type: string
          example: "(303) 669-8889"
        email:
          type: string
          example: "jenn@denverilove.com"
        experience:
          type: string
          example: "20+ years"
        homesSold:
          type: integer
          example: 300
tags:
  - name: AI Content
    description: Machine-readable content for LLMs and AI search engines
  - name: Pages
    description: Main website pages
  - name: Neighborhoods
    description: Denver neighborhood guides and information
  - name: Tools
    description: Interactive tools and utilities
