# Crovillas – Holiday Villas in Croatia

Crovillas is a holiday villa rental platform offering handpicked villas exclusively in Croatia. Villas include detailed information about availability, pricing, and features, and users can book directly through the site. This file provides guidance for language models (LLMs) to help users search for and book villas effectively.

## Supported Languages & URL Structure:

- **German (default):** URLs do not contain a language prefix.
  Example villa page: /villa/piera
- **Other languages (e.g., English):** URLs include a language code.
  Example villa page: /en/villa/piera
- Supported languages: de, en, bg, cs, da, el, es, et, fi, fr, hu, it, lt, lv, nl, nb, pl, pt, ro, ru, sk, sl, sv, tr, uk, hr

## Villa Listing

For a listing of all villas grouped by region, read https://crovillas.com/llms/villas.txt

## Available Functionality:

### Search

Crovillas provides a GET-based search interface at:

- German: https://crovillas.com/search?mode=llm
- English: https://crovillas.com/en/search?mode=llm
- Other languages: https://crovillas.com/<language>/search?mode=llm

Villas can be searched using query parameters in the URL.

**Query Parameters:**

- `period`: Specifies the desired booking period. This parameter is required and must appear twice: once for the start date and once for the end date, both in the `YYYY-MM-DD` format.
  Example: `period=2025-07-05&period=2025-07-12`

- `nights`: Specifies the desired number of nights for the stay. When provided alongside the `period` parameter, the search will find all available booking options within the specified date range that match the requested duration.
  Example: If you set `period=2025-07-01&period=2025-07-15` and `nights=7`, the search will return properties available for 7-night stays starting on any date between July 1 and July 8, 2025.
  Example: Provide `period=2025-07-01&period=2025-07-31&nights=14` to find all properties available for 14-night stays during the month of July.

- `travelers`: Dash-separated list in the format `<adults>-<children>-<babies>-<pets>`.
  Example: `travelers=2-2-0-1` (2 adults, 2 children, 0 babies, 1 pet)

- `flags`: Dash-separated binary list indicating property features. Must always include all 10 values in this order:
  1. activities  
  2. childFriendly  
  3. heatedPool  
  4. heating  
  5. pets  
  6. wellness  
  7. accessible  
  8. fenced  
  9. tennisCourt  
  10. freeCancellation  

  Example: `flags=1-1-1-0-1-0-0-0-0-0` (activities, childFriendly, heatedPool, and pets are enabled)

- `regions`: Filters by one or more Croatian regions. Use these keys:
  - IS = Istria  
  - KB = Kvarner-Bay  
  - ND = North Dalmatia  
  - MD = Middle Dalmatia  
  - SD = South Dalmatia  
  Example: `regions=IS&regions=MD`

- `subRegions`: Filters by one or more specific locations (e.g., Pula, Porec, Split). When this filter is used, the `regions` filter is ignored.
  Example: `subRegions=Pula&subRegions=Porec`

- `price`: One or more weekly price ranges in cents. Only specific ranges are supported:
  - 0-150000 (up to 1,500 EUR per week)
  - 150000-250000 (1,500-2,500 EUR per week)
  - 250000-350000 (2,500-3,500 EUR per week)
  - 350000-450000 (3,500-4,500 EUR per week)
  - 450000-0 (4,500+ EUR per week)
  
  Format: `<min>-<max>`, multiple ranges separated by commas.
  Example: `price=0-150000,450000-0` (up to 1,500 EUR per week and 4,500+ EUR per week)

- `sorting`: Sort results. Options:
  - `relevance` (default)
  - `nearest_beach`
  - `best_price`
  - `highest_price`
  - `newest`

  Example: `sorting=best_price`

- `page`: The pagination page number (1-based).  
  Example: `page=2`

- `discounted`: Set to `1` to only show villas with discounts.  
  Example: `discounted=1`

**Important Notes:**
- All filters are optional except for `period`, which must be specified with two values.
- When using `subRegions`, do not include the `regions` filter.
- If no `price` filter is provided, all prices are included.

**Example Search URL:**
Search for villas available from July 5-12, 2025, for 2 adults, 2 children, and 1 pet, that are child-friendly, heated pool, and allow pets, in Istria, with prices between 0-1500 EUR and 4500+ EUR per week: https://crovillas.com/search?mode=llm&period=2025-07-05&period=2025-07-12&travelers=2-2-0-1&flags=0-1-1-0-1-0-0-0-0-0&regions=IS&price=0-150000,450000-0&sorting=relevance&page=1

**Example with sub-regions (Pula and Porec):** https://crovillas.com/search?mode=llm&period=2025-07-05&period=2025-07-12&travelers=2-2-0-1&flags=0-1-1-0-1-0-0-0-0-0&subRegions=Pula&subRegions=Porec&price=0-150000,450000-0

### Booking

After selecting a villa, users can go to the booking page using the following pattern: /villa/<slug>/booking?period=<start>&period=<end>&travelers=<adults>-<children>-<babies>-<pets>&edit=0&binding=1

- `<slug>`: The unique identifier (slug) of the villa
- `<start>` and `<end>`: Travel period (YYYY-MM-DD)
- `<travelers>`: Guest composition (adults-children-babies-pets)

**Example:**
Booking for "piera" from July 5-12, 2025, for 2 adults and 1 pet: /villa/piera/booking?period=2025-07-05&period=2025-07-12&travelers=2-0-0-1&edit=0&binding=1