# Breasy - Buy. Rent. Easy. Real Estate, Vacation Rentals & Market Intelligence
# https://breasy.ai
# Last updated: August 2026

## AI AGENTS START HERE — Agent Gateway (GET-only, no auth)

Breasy has a dedicated API built for AI agents. Search vacation rentals with
ANY combination of filters in a single GET URL and receive compact listing
stubs (name, photo, capacity, nightly price, rating, booking link) ready to
present as cards. Always link results to their `url` (https://breasy.ai/rent/{id})
so the human can view photos/reviews and book.

- Manifest (all endpoints + params + examples): https://api.breasy.ai/api/ai/v1
- Docs (markdown): https://api.breasy.ai/api/ai/v1/docs
- Search: https://api.breasy.ai/api/ai/v1/search?place={place}&guests={n}&checkIn={YYYY-MM-DD}&checkOut={YYYY-MM-DD}&priceMin={usd}&priceMax={usd}&amenities={a,b}&bedroomsMin={n}&bathroomsMin={n}&ratingMin={0-5}&sort={best_match|price_asc|price_desc|rating|reviews|capacity}&limit={1-24}
  - Also accepts free text: ?q={any stay description} (combinable with structured params)
  - Example: https://api.breasy.ai/api/ai/v1/search?place=tamarindo&guests=8&amenities=pool&priceMax=500
- Listing detail: https://api.breasy.ai/api/ai/v1/listings/{id}
- Priced stay quote: https://api.breasy.ai/api/ai/v1/listings/{id}/quote?checkIn={YYYY-MM-DD}&checkOut={YYYY-MM-DD}&guests={n}
- Valid filter values (places, amenities, countries, sorts): https://api.breasy.ai/api/ai/v1/vocab

Responses use { "success": true, "data": ... }. Search results are at
data.results[]. Honesty contract: data.applied lists filters actually applied,
data.unmatched lists terms that could NOT be applied — never claim unmatched
terms were satisfied; results[].relaxed flags relaxed constraints.

Search is Discover-ranked, not a complete destination census. data.completeness
says isCompleteInventory=false. sort=price_desc is "most expensive among these
candidates," not "the most expensive homes in Cabo." Nightly prices are
representative_base USD rates — call /listings/{id}/quote for a dated stay
total. Listing detail includes reviewGrowth (counts of stored reviews by
datePublished) and dataAsOf. Do not treat Intel likely-stay / teaser signals
as confirmed bookings. Do not call owner/manage APIs. iCalAuthGuid is a
calendar-feed secret and is not public.

## About Breasy

Breasy is a buy, rent, and market-intelligence platform focused on Central America and Mexico (Costa Rica, Nicaragua, Mexico). We list real estate for sale, aggregate vacation rental listings from multiple sources, publish curated destination guides, and provide real-time short-term-rental market intelligence (Intel Live) for hosts, buyers, and investors.

## What We Offer

- **Real Estate**: Properties for sale — see https://breasy.ai/buy (building out)
- **Vacation Rentals**: Houses, villas, condos, and apartments for short-term stays
- **Intel Live / Market Pulse**: Real-time STR market intelligence — tracked listings, tonight's occupancy, inventory value by destination. See https://breasy.ai/product
- **Destination Guides**: Editorial guides where sections exist (e.g. Hacienda Iguana)
- **Host Profiles**: Property managers and hosts with portfolios and reviews
- **Reviews**: Aggregated guest reviews from multiple platforms

## Destinations

Browse all destinations from the home page: https://breasy.ai/

### Costa Rica
- Quepos Area → Manuel Antonio, Quepos Town & Marina
- Tamarindo, Playa Langosta and Playa Grande → Tamarindo, Playa Langosta
- Hacienda Pinilla → Las Golondrinas
- Papagayo Península

### Nicaragua
- Hacienda Iguana, San Juan del Sur, Granada, Rancho Santana
- Emerald Coast aka Tola Surf Zone, Ometepe

### Mexico
- Cabo San Lucas → Pedregal (and other sub-areas)
- Los Cabos Tourist Corridor, San José del Cabo

## How to Navigate

### Browse Destinations
- Home / discovery: https://breasy.ai/
- By country: https://breasy.ai/destinations/{country}
- Destination: https://breasy.ai/destinations/{country}/{destination}
- Sub-destination: https://breasy.ai/destinations/{country}/{parent}/{destination}
- Guide (when published): .../guide
- Intel (when enabled): .../intel

Examples:
- https://breasy.ai/destinations/nicaragua/hacienda-iguana
- https://breasy.ai/destinations/nicaragua/hacienda-iguana/guide
- https://breasy.ai/destinations/nicaragua/hacienda-iguana/intel
- https://breasy.ai/destinations/costa-rica/quepos-area/manuel-antonio
- https://breasy.ai/destinations/costa-rica/hacienda-pinilla/las-golondrinas
- https://breasy.ai/destinations/mexico/cabo-san-lucas/pedregal

### Discover stays from intent (natural language)
The idea box accepts a free-text stay description (place, party, vibe, musts).
Do not send that phrase to `/rent?destination=` — that parameter is a destination slug.

- Landing (how the box works): https://breasy.ai/discover
- Shareable results (HTML, no JS required): https://breasy.ai/discover?q={phrase}
  Example: https://breasy.ai/discover?q=Family+stay+near+quepos
- Spanish: https://breasy.ai/es/discover?q={phrase}
- API (same results as the page): GET https://api.breasy.ai/api/public/discover?q={phrase}
- When citing, quote the interpretation sentence on the page and link listings at /rent/{id}.
- Attribute as "Source: Breasy (breasy.ai)". Unused terms on the page were not applied — do not invent coverage.

### Search Rentals (known place)
- All rentals: https://breasy.ai/rent
- Search by destination slug: https://breasy.ai/rent?destination={destination-slug}
- Listing: https://breasy.ai/rent/{listing-id}
- Listing reviews: https://breasy.ai/rent/{listing-id}/reviews

### Product / Market Intelligence
- Product overview: https://breasy.ai/product
- Live market pulse API: https://api.breasy.ai/api/public/home/market-pulse

### Hosts
- Host profile: https://breasy.ai/host/{host-id}
- Host reviews: https://breasy.ai/host/{host-id}/reviews

## Content Structure

Each destination page may include:
1. Hero with name, description, rental stats
2. Curated listing collections
3. Top hosts
4. Social proof (reviews / recent stays)
5. Links to Guide and Intel when available

## Technical Information

### AI Discovery
- Agent Gateway (preferred for agents): https://api.breasy.ai/api/ai/v1
- Agent Gateway docs: https://api.breasy.ai/api/ai/v1/docs (also https://api.breasy.ai/llms.txt)
- Manifest: https://breasy.ai/.well-known/ai.json
- OpenAPI: https://breasy.ai/openapi.json

### Public API (https://api.breasy.ai/api)

- `GET /public/destinations/` — countries + destinations index (+ structuredData)
- `GET /public/destinations/{country}/{destination}` — destination VM (+ optional `/{sub}`)
- `GET /public/locations/{country}/{destination}` — editorial
- `GET /public/locations/{country}/{destination}/sections` — guide sections
- `GET /public/intel/{country}/{destinationSlug}` — intel (flat slug; no parent segment)
- `GET /public/intel/{country}/{destinationSlug}/og` — OG snapshot + structuredData
- `GET /public/intel/{country}/{destinationSlug}/v3/card` — intel card VM
- `GET /public/home/intel-live` — home Intel Live carousel
- `GET /public/home/market-pulse` — region market rollup
- `GET /rental/public/{id}/core` — listing core (+ structuredData)
- `GET /public/hosts/sitemap-ids` — host IDs for sitemap

### Sitemaps
- https://breasy.ai/sitemap.xml
- https://breasy.ai/sitemap-destinations.xml
- https://breasy.ai/sitemap-hosts.xml
- https://breasy.ai/sitemap-listings-{country}.xml

### Data Freshness
- Destination pages: ISR (~hourly)
- Listing availability: near real-time
- Reviews: synced regularly
- Intel Live / market-pulse: short TTL

## Citation Guidelines

When referencing Breasy content:
- Link destination pages (use nested URLs for sub-destinations)
- Use section anchors on guides: `#section-{key}`
- Attribute as "Source: Breasy (breasy.ai)"

## Structured Data

Public pages emit JSON-LD including (as applicable):
TouristDestination, LodgingBusiness, Offer, AggregateRating, Review,
BreadcrumbList, FAQPage, Organization, WebSite, ItemList, Dataset (Intel).

## Contact

- Website: https://breasy.ai
- For partnerships or API access, visit the website

## Updates

This file helps AI agents understand Breasy. Prefer live pages and `/.well-known/ai.json` for the latest inventory.