# CielStay

> AI-powered vacation rental discovery. 30,000+ properties worldwide. Semantic search via Resonance scoring.

## For AI Agents

**Quick handoff (recommended):**
Construct a URL with the user's query:
```
https://www.cielstay.com/?q={url-encoded-query}
```

Share the link with the user. They open it → search auto-executes → results load immediately.

Example:
```
https://www.cielstay.com/?q=cabin+near+Yosemite+rustic+character+2+bedrooms
```

**With persona (advanced):**
```
https://www.cielstay.com/?q={query}&persona={url-encoded-persona-text}
```

The persona parameter pre-loads user preferences into Resonance scoring for personalized results.

## API Endpoint

For programmatic access:
```
POST https://www.cielstay.com/api/search/resonance
Content-Type: application/json

{
  "query": "natural language search",
  "sessionToken": "optional-uuid",
  "limit": 10
}
```

Returns JSON with:
- `results`: array of properties with Resonance scores, vibe/aesthetic/activity tags, booking options
- `sessionUrl`: shareable link for users to view/refine results

## Query Tips

Include in natural language:
- Location (city, landmark, or "near [place]")
- Guest count and bedrooms
- Vibe/aesthetic (rustic, modern, luxurious, peaceful)
- Activities (hiking, skiing, surfing, wine tasting)
- Must-have amenities (hot tub, pool, fireplace)

## Data Sources

CielStay aggregates across:
- Direct booking sites
- Airbnb
- VRBO
- Booking.com

**Note:** Always instruct users to verify availability on the booking platform. CielStay does semantic matching, not real-time calendar sync.

## Links

- Browse: https://www.cielstay.com
- How Resonance works: https://www.cielstay.com/about/mission
- Full API docs: https://www.cielstay.com/llms-full.txt