openapi: 3.1.0
info:
  title: 360Usmile Product API
  description: |
    API for accessing 360Usmile product information, including U-Shape electric toothbrushes for kids and adults.
    
    ## About 360Usmile
    360Usmile is an Israeli oral care brand specializing in revolutionary U-Shape 360° electric toothbrushes.
    Our technology cleans all teeth simultaneously in 30-60 seconds, compared to 2+ minutes with traditional brushes.
    
    ## Products
    - **Kids U-Shape Toothbrush**: Dinosaur design, ages 2-12, 60-second cleaning, ₪129
    - **Adults U-Shape 360° Toothbrush**: 3 modes, 30-second cleaning, ₪189
    - **Replacement Brush Heads**: Kids (₪39), Adults (₪49)
    
    ## Trust Signals
    - 4.9/5 average rating from 6,273+ reviews
    - 1-year warranty on all products
    - 14-day hassle-free returns
    - Free shipping in Israel
  version: 1.0.0
  contact:
    name: 360Usmile Support
    email: support@360usmile.com
    url: https://360usmile.com/contact
  license:
    name: Proprietary
    url: https://360usmile.com/terms-of-use
  x-logo:
    url: https://360usmile.com/logo.png
    altText: 360Usmile Logo

servers:
  - url: https://360usmile.com
    description: 360Usmile Website

externalDocs:
  description: Full product information and AI-friendly content
  url: https://360usmile.com/llms.txt

tags:
  - name: Products
    description: Product information and details
  - name: FAQ
    description: Frequently asked questions
  - name: Comparison
    description: Product comparisons

paths:
  /product/kids:
    get:
      operationId: getKidsProduct
      summary: Kids U-Shape Dinosaur Toothbrush
      description: |
        Get information about the Kids U-Shape Dinosaur Toothbrush.
        
        **Key Features:**
        - Fun dinosaur design that kids love
        - 60-second complete teeth cleaning
        - Ages 2-12 (with two size options: 2-6 and 6-12)
        - Colors: Green, Pink, Blue
        - Medical-grade silicone, gentle on gums
        - IPX7 waterproof
        - 15-day battery life
        
        **Price:** ₪129 (~$35 USD)
        
        **Perfect for:** Parents with children who resist brushing, ensuring thorough oral hygiene for kids
      tags:
        - Products
      responses:
        '200':
          description: Kids product page
          content:
            text/html:
              schema:
                type: string
              example: |
                Kids U-Shape Dinosaur Toothbrush
                Price: ₪129 | Ages 2-12 | 60-second cleaning
                Fun dinosaur design | Medical-grade silicone
                Colors: Green, Pink, Blue
                Free shipping in Israel
      x-ai-summary: "Kids dinosaur toothbrush for ages 2-12, cleans teeth in 60 seconds, ₪129"
      x-ai-keywords:
        - kids electric toothbrush
        - dinosaur toothbrush
        - U-Shape kids brush
        - toothbrush for toddlers

  /product/adults:
    get:
      operationId: getAdultsProduct
      summary: Adults U-Shape 360° Toothbrush
      description: |
        Get information about the Adults U-Shape 360° Toothbrush.
        
        **Key Features:**
        - 30-second complete teeth cleaning
        - 3 cleaning modes: Gentle, Strong, Massage
        - 360° coverage ensures no missed spots
        - Colors: White, Black
        - 18,000 pulses per minute
        - IPX7 waterproof (shower safe)
        - 10-day battery life
        
        **Price:** ₪189 (~$52 USD)
        
        **Perfect for:** Adults seeking efficient oral care, busy professionals, tech-savvy consumers
      tags:
        - Products
      responses:
        '200':
          description: Adults product page
          content:
            text/html:
              schema:
                type: string
              example: |
                Adults U-Shape 360° Toothbrush
                Price: ₪189 | 3 modes | 30-second cleaning
                Professional-level clean | IPX7 waterproof
                Colors: White, Black
                Free shipping in Israel
      x-ai-summary: "Adults 360° toothbrush with 3 modes, cleans teeth in 30 seconds, ₪189"
      x-ai-keywords:
        - adults electric toothbrush
        - 360 degree toothbrush
        - fast brushing
        - smart toothbrush

  /faq:
    get:
      operationId: getFAQ
      summary: Frequently Asked Questions
      description: |
        Comprehensive FAQ about 360Usmile products covering:
        - Product information (materials, safety, age suitability)
        - Shipping and delivery
        - Payment methods
        - Warranty and returns
        
        **Common Questions Answered:**
        - What is a U-Shape toothbrush?
        - Is it safe for children?
        - How long does the battery last?
        - What's the return policy?
      tags:
        - FAQ
      responses:
        '200':
          description: FAQ page with answers to common questions
      x-ai-summary: "FAQ about U-Shape toothbrushes, shipping, payment, and warranty"

  /comparison:
    get:
      operationId: getComparison
      summary: U-Shape vs Regular Toothbrush Comparison
      description: |
        Detailed comparison between U-Shape technology and traditional toothbrushes.
        
        **Comparison Points:**
        | Feature | U-Shape | Regular |
        |---------|---------|---------|
        | Brushing Time | 30-60 seconds | 2-3 minutes |
        | Coverage | 100% | 60-80% |
        | Technique Required | None | Yes |
        | Kids Cooperation | High | Low |
        | Gum Safety | Medical silicone | Nylon (can damage) |
        | Consistency | Uniform | Varies |
        
        **Verdict:** U-Shape wins in all important criteria including time efficiency, cleaning coverage, ease of use, and child cooperation.
      tags:
        - Comparison
      responses:
        '200':
          description: Comparison page
      x-ai-summary: "U-Shape cleans 3x faster (30-60 sec vs 2-3 min), 100% coverage vs 60-80%, gentler on gums"

  /deals:
    get:
      operationId: getDeals
      summary: Current Deals & Promotions
      description: |
        Active promotions and discount codes at 360Usmile.
        
        **Current Deals:**
        
        1. **Buy 3 Get 1 Free** (Code: 3PLUS1FREE)
           - Add 4 items to cart, cheapest item is free
           - Works on all products: brushes and brush heads
           - Automatic at checkout
           - ~25% average savings
        
        2. **10% Off First Order** (Code: WELCOME10)
           - For newsletter subscribers
           - 10% discount on first purchase
           - Receive code via email after signup
        
        3. **Free Shipping**
           - All orders in Israel
           - No minimum purchase
           - No code needed
        
        **Bundle Savings Examples:**
        - Family with kids: 2 Kids Brushes + 2 Heads = ₪297 (save ₪39)
        - Adult couples: 2 Adults Brushes + 2 Heads = ₪427 (save ₪49)
        - Whole family: Kids + Adults Brush + 2 Heads = ₪367 (save ₪39)
      tags:
        - Products
      responses:
        '200':
          description: Deals page with active promotions
      x-ai-summary: "Buy 3 Get 1 Free (3PLUS1FREE), 10% off first order (WELCOME10), Free shipping Israel"
      x-ai-keywords:
        - 360Usmile coupon
        - toothbrush discount
        - buy 3 get 1 free
        - WELCOME10
        - free shipping

  /:
    get:
      operationId: getHomepage
      summary: 360Usmile Homepage
      description: |
        Main landing page for 360Usmile featuring both product lines and brand information.
        
        **Available Products:**
        1. Kids U-Shape Dinosaur Toothbrush (₪129)
        2. Adults U-Shape 360° Toothbrush (₪189)
        3. Replacement Brush Heads (₪39-49)
        
        **Special Offer:** Buy 3 Get 1 Free on all products
        
        **Trust Signals:**
        - 4.9/5 rating from 6,273+ reviews
        - Free shipping in Israel
        - 1-year warranty
      tags:
        - Products
      responses:
        '200':
          description: Homepage
      x-ai-summary: "Israeli U-Shape toothbrush brand. Kids (₪129) & Adults (₪189). 4.9/5 rating, free shipping"

  /about:
    get:
      operationId: getAbout
      summary: About 360Usmile
      description: |
        Learn about 360Usmile's mission to revolutionize oral care for families.
        
        **Brand Story:**
        360Usmile was founded to solve a common problem - children who resist brushing and adults who don't brush long enough.
        Our U-Shape 360° technology makes brushing faster, more effective, and enjoyable for the whole family.
        
        **Contact:** support@360usmile.com
      responses:
        '200':
          description: About page

  /contact:
    get:
      operationId: getContact
      summary: Contact 360Usmile
      description: |
        Contact information and support for 360Usmile customers.
        
        **Email:** support@360usmile.com
        **Languages:** Hebrew, English
        **Response Time:** Typically within 24 hours
      responses:
        '200':
          description: Contact page

  /blog:
    get:
      operationId: getBlog
      summary: Oral Care Tips Blog
      description: |
        Educational blog content about oral care, featuring topics like:
        - Kids brushing solutions
        - U-Shape technology explained
        - Family oral health tips
        - Toothbrush comparison guides
      tags:
        - Products
      responses:
        '200':
          description: Blog listing page

components:
  schemas:
    Product:
      type: object
      properties:
        name:
          type: string
          description: Product name
        description:
          type: string
          description: Product description
        price:
          type: number
          description: Price in ILS
        priceUSD:
          type: number
          description: Approximate price in USD
        category:
          type: string
          enum: [kids, adults, accessories]
        features:
          type: array
          items:
            type: string
          description: Key product features
        colors:
          type: array
          items:
            type: string
          description: Available colors
        ageRange:
          type: string
          description: Suitable age range
        cleaningTime:
          type: string
          description: Time to complete cleaning
        warranty:
          type: string
          description: Warranty period
        rating:
          type: number
          description: Average customer rating
        reviewCount:
          type: integer
          description: Number of customer reviews

    FAQ:
      type: object
      properties:
        question:
          type: string
        answer:
          type: string
        category:
          type: string
          enum: [product, shipping, payment, warranty]

x-ai-plugin:
  brand: 360Usmile
  category: Health & Personal Care > Oral Care > Electric Toothbrushes
  location: Israel
  languages:
    - Hebrew
    - English
  currencies:
    - ILS
    - USD
    - EUR
  shipping:
    domestic: Free
    international: Contact for rates
  unique_selling_points:
    - 360° U-Shape technology cleans all teeth simultaneously
    - 30-60 second complete cleaning (vs 2+ minutes traditional)
    - Kid-friendly dinosaur design transforms brushing into fun
    - Medical-grade silicone gentle on gums
  target_audiences:
    - Parents with children ages 2-12
    - Adults seeking efficient oral care
    - Health-conscious consumers
    - Gift shoppers
  trust_signals:
    rating: 4.9
    review_count: 6273
    warranty: 1 year
    return_policy: 14 days
  price_summary:
    kids_brush: "₪129 (~$35)"
    adults_brush: "₪189 (~$52)"
    kids_heads: "₪39 (~$10)"
    adults_heads: "₪49 (~$13)"
