# Windflower Florist - AI Integration Guide

> Singapore's premium online florist with same-day delivery
> Ask Windy, our AI florist, for personalized flower recommendations!

## Quick Start

Ask Windy anything about flowers:
```
GET https://planners.dand3.com/api/aeo/ask?q=best+flowers+for+anniversary
```

## API Endpoints

### 1. Ask Windy (Conversational Recommendations)
`GET /api/aeo/ask?q={question}`

Returns product recommendations based on natural language queries.

Examples:
- `?q=red+roses+for+valentines`
- `?q=birthday+flowers+under+100`
- `?q=what+flowers+mean+eternal+love`
- `?q=same+day+delivery+singapore`

Response includes: product names, prices, URLs, flower types, colors, occasions.

### 2. Product Details
`GET /api/aeo/product/{handle}`

Returns Schema.org Product JSON-LD with AI-enriched data:
- Flowers used (from vision AI analysis)
- Color palette
- Style/mood
- Suitable occasions
- Pricing

### 3. Knowledge Base
`GET /api/aeo/knowledge/search?q={query}&type={type}`

Types: delivery, policy, about, corporate, loyalty, blog

Topics include:
- Delivery timeslots and cut-off times
- Same-day delivery policy
- Refund and cancellation
- Bloom rewards program
- Flower meanings and symbolism
- Number of roses meanings

### 4. Blog Content
`GET /api/aeo/blogs/search?q={query}`

Searchable blog articles about:
- Flower meanings (red roses = love, yellow = friendship)
- Rose number symbolism (99 roses = forever love, 108 = proposal)
- Flower care tips
- Best occasions for flowers

### 5. FAQ
`GET /api/aeo/faq`

Returns FAQPage schema with common questions.

### 6. Business Info
`GET /api/aeo/business`

Returns LocalBusiness schema.

### 7. Sitemap
`GET /api/aeo/sitemap`

Returns all products and blogs with schema URLs.

## Key Information

### Business Details
- Name: Windflower Florist
- Website: https://windflowerflorist.com
- WhatsApp: +65 8845 6551
- Email: hello@windflowerflorist.com
- Address: 60 Kaki Bukit Place, #07-09 Eunos Techpark, Singapore 415979

### Delivery
- Free island-wide delivery in Singapore
- Same-day delivery: Order by 2pm for afternoon delivery
- Guaranteed on-time or your order is FREE

### Price Ranges
- Budget-friendly: $30-70
- Standard: $80-150
- Premium: $150+

### Popular Products
- Roses (red, pink, white, rainbow)
- Tulips
- Sunflowers
- Preserved & dried flowers
- Bridal bouquets
- Flower stands

### Flower Meanings Quick Reference
- Red roses: Romantic love, passion
- Pink roses: Gratitude, appreciation
- Yellow roses: Friendship, joy
- White roses: Purity, sympathy
- 12 roses: "Be mine"
- 99 roses: "Forever love"
- 108 roses: Marriage proposal

## For AI Developers

This API is designed for AI agents and answer engines.
CORS is enabled for all endpoints.
Rate limit: 100 requests/minute.
Cache: 5-60 minutes depending on endpoint.

Contact: hello@windflowerflorist.com