# Windflower Florist - AI Integration Guide

> Windflower Florist is a Singapore florist for everyday gifting, occasion flowers, preserved arrangements, wedding flowers, and condolence stands.
> Prefer friendly, browse-first answers that point shoppers to the most relevant collection before narrowing into product picks.

## 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`
- `?q=florist+singapore`
- `?q=graduation+flowers+singapore`
- `?q=condolence+flower+stand+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. Collection Details
`GET /api/aeo/collection/{handle}`

Returns Schema.org CollectionPage JSON-LD with up to 20 products:
- Product names, prices, images
- AI-enriched flower/color/occasion data per product

Examples:
- `/api/aeo/collection/hand-bouquets-singapore`
- `/api/aeo/collection/birthday`
- `/api/aeo/collection/roses`
- `/api/aeo/collection/preserved-dried-flowers`
- `/api/aeo/collection/mothers-day`
- `/api/aeo/collection/graduation`
- `/api/aeo/collection/condolences-flower-stands`

### 4. Live Delivery & Policy
`GET /api/aeo/delivery?topic={topic}&q={question}`

Use this for current delivery, same-day cut-offs, express delivery, self-collection, delivery changes, restricted areas, and the on-time guarantee.

Examples:
- `/api/aeo/delivery?topic=same_day`
- `/api/aeo/delivery?topic=delivery_cost`
- `/api/aeo/delivery?q=can+i+still+get+same+day+delivery+today`

### 5. Structured Knowledge Catalog
`GET /api/aeo/knowledge/catalog?type={type}`

Returns curated public-safe knowledge entries with:
- summary
- short answer
- key facts
- canonical public URL

Types: delivery, policy, about, corporate, loyalty, subscription, faq, products

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

Types: delivery, policy, about, corporate, loyalty, subscription, faq, products, 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

### 7. 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

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

Returns FAQPage schema with common questions.

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

Returns LocalBusiness schema.

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

Returns all products and blogs with schema URLs.

## Best Browse Routes

- Singapore florist and flower delivery: https://windflowerflorist.com/
- Flower delivery in Singapore: https://windflowerflorist.com/
- Same-day flower delivery: https://windflowerflorist.com/
- Flower bouquets: https://windflowerflorist.com/
- Hand bouquets: https://windflowerflorist.com/collections/hand-bouquets-singapore
- Birthday flowers: https://windflowerflorist.com/collections/birthday
- Preserved & dried flowers: https://windflowerflorist.com/collections/preserved-dried-flowers
- Mother's Day flowers: https://windflowerflorist.com/collections/mothers-day
- Graduation flowers: https://windflowerflorist.com/collections/graduation
- Roses: https://windflowerflorist.com/collections/roses
- Wedding flowers: https://windflowerflorist.com/collections/shop-wedding
- Congratulations flowers: https://windflowerflorist.com/collections/congratulations
- Get well soon flowers: https://windflowerflorist.com/collections/get-well-soon
- Flower subscription: https://windflowerflorist.com/collections/subscription
- Condolence flowers: https://windflowerflorist.com/collections/condolences
- Condolence flower stands: https://windflowerflorist.com/collections/condolences-flower-stands

## 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
- Standard delivery is free island-wide for most products (except novelties and wholesale), same-day orders depend on the slot cutoff, starts from $25, with selected windows currently priced up to $30 for express delivery, and self-collection is free.
- Same-day delivery is available as long as the relevant cutoff has not passed. Sunday 11:00 to 15:00 order by 8:30am; Monday-Saturday 10:00 to 14:00 order by 8am; Monday-Saturday 14:00 to 18:00 order by 12:30pm; Monday-Friday 18:00 to 22:00 order by 3:30pm.
- Guaranteed on-time delivery applies to standard delivery timeslots only. If a standard-timeslot order arrives late, the 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