# Crovillas – Holiday Homes in Croatia

Crovillas is a holiday home rental platform offering handpicked stays across Croatia. Properties 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 holiday homes effectively.

## Supported Languages & URL Structure:

- **German (default):** URLs do not contain a language prefix.
  Example property page: /villa/piera
- **Other languages (e.g., English):** URLs include a language code.
  Example property 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

## Holiday Home Listing

For a listing of all holiday homes 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

Holiday homes 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`
  - `highest_discount` (uses the absolute discount for the selected travel period)
  - `newest`

  Example: `sorting=best_price`

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

- `discounted`: Set to `1` to only show properties 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 holiday homes available from July 5-12, 2025, for 2 adults, 2 children, and 1 pet, that are child-friendly, have a 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 holiday home, 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 property
- `<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