Search holiday offers
search_holidaysFull Description
Finds VakantieDiscounter holiday offers and returns matching accommodations or packages with prices, dates, and images.
The more specific the user's preferences are — such as destination, departure airport, travel dates, or budget — the easier it is to surface good-value holiday deals.
Do NOT use for:
- Standalone flight searches without accommodation
- Restaurant or dining recommendations
- Visa, passport, or travel document questions
- General destination information without booking intent
Parameters (1 required, 18 optional)
userQuerystringThe query that user typed into the chat window; pass it through unchanged
arrivaldateendstringLatest return date for flexible travel (YYYY-MM-DD). Use with departuredatestart. Always use next future occurrence of a date. Never use past dates. Triggers: - month → last day - season or holiday → last day - "eind september" → range end Do NOT use for exact single dates (use departuredate instead). Examples (paired with departuredatestart): (if today is 2026-01-15) "maart" → "2026-03-31" (if today is 2026-05-01) "maart" → "2027-03-31" (if today is 2026-05-01) "zomer" → "2026-09-22" (if today is 2026-05-01) "september" → "2026-09-30" (if today is 2026-05-01) "eind september" → "2026-09-30" "18 november" → {} (use departuredate instead)
boardingtypearrayIncluded meal plan for the accommodation. Key values (enum has more): - "AI" = All Inclusive - "HP" = Halfpension (breakfast + dinner) - "VP" = Volpension (all meals) - "LO" = Logies + ontbijt (breakfast only) - "LG" = Logies (accommodation only, no meals) Do NOT use for food quality ("lekker eten", "goed eten"), dietary preferences, or restaurant quality. Examples: "all inclusive" → ["AI"] "met ontbijt" → ["LO"] "avondeten inbegrepen" → ["HP"] "geen all inclusive" → ["LO", "HP", "VP"] "lekker eten" → {}
cityarraycountrycodearraydepartureairportarraydeparturedatestringExact single departure date (YYYY-MM-DD). Always use next future occurrence of a date. Never use past dates. Do NOT use for date ranges, months, approximate timeframes, or climate/weather context ("warm in november"). Examples: (if today is 2026-01-15) "vertrek 18 maart" → "2026-03-18" (if today is 2026-05-01) "vertrek 18 maart" → "2027-03-18" (if today is 2026-05-01) "18 september" → "2026-09-18" (if today is 2026-05-01) "volgende week donderdag" → "2026-05-07" "maart" → {} (use departuredatestart instead)
departuredatestartstringEarliest departure date for flexible travel (YYYY-MM-DD). Use with arrivaldateend. Always use next future occurrence of a date. Never use past dates. Triggers: - month → first day - season or holiday → first day - "begin maart" → range start Do NOT use for exact single dates (use departuredate instead). Examples (paired with arrivaldateend): (if today is 2026-01-15) "maart" → "2026-03-01" (if today is 2026-05-01) "maart" → "2027-03-01" (if today is 2026-05-01) "zomer" → "2026-06-21" (if today is 2026-05-01) "september" → "2026-09-01" (if today is 2026-05-01) "eind september" → "2026-09-20" "18 november" → {} (use departuredate instead)
distancebeachstringMaximum distance to beach in meters. Defaults: - "aan het strand", "boulevard" → "100" - "dichtbij", "vlakbij" → "250" - "loopafstand", "niet ver van" → "500" Do NOT use for beach activities, room features (zeezicht), or "strand" in hotel/location names. Examples: "Strand" → "250" "aan strand" → "100" "vlakbij het strand" → "250" "strand te lopen" → "500" "max 200m van zee" → "200" "afstand strand maakt niet uit" → "none" "strand waterpret" → {}
distancecitystringMaximum distance to city center ("centrum", "de stad", "het dorp", "de oude stad") in meters. Defaults: - "dichtbij", "vlakbij", "nabij", "loopafstand", "niet ver van" → "500" - "bij een stadje", "in de buurt van een dorp" → "2000" Do NOT use for: staying IN center, specific places/landmarks, public transport, restaurants/amenities, or quality descriptions ("gezellig dorpje", "sfeervol centrum"). Examples: "max 600m van het centrum" → "600" "op loopafstand van de stad" → "500" "bij een stadje" → "2000" "in centrum" → {} "dichtbij Salou" → {} "treinstation dichtbij" → {} "gezellig dorpje" → {}
facilityarrayAccommodation facilities and amenities requested by the user. Less obvious values: - "animation" = Entertainment/animation team - "creche" = Nursery/daycare for babies - "relax" = Relaxation facilities - "small" = Small/boutique property - "nearcenter" = Near city center - "nearthebeach" = Near the beach Examples: "pool and wifi" → ["outdoorpool", "wifi"] "bij de boulevard" → ["nearthebeach"] "kindervrij" → ["adultonly"] "goed eten" → {}
flexibilitystringChecks departure dates within N days before and after the specified date. Always pair with departuredate. Defaults: "2" for "rond/ongeveer"; "5" for larger flexibility. Examples: "rond 15 maart" → flexibility: "2", departuredate: "YYYY-03-15" "in de week van 1 juni" → flexibility: "5", departuredate: "YYYY-06-01" "precies op 10 november" → {}
maxpricestringMaximum price per person in cents. When user specifies total budget: divide by party size (default 2). For price ranges: use the higher value. Do NOT use for quality mentions ("goed hotel"), distance ("max 500m"), or time constraints. Examples: "max 450 euro pp" → "45000" "totaal max 6000 euro voor 2" → "300000" "rond 300/400 pp" → "40000" "goedkoop" → "25000" "goed hotel" → {} "max 2 uur vliegen" → {}
ratingstringMinimum guest review score (n or higher). "goed beoordeeld" or similar defaults to "8". Examples: "goede beoordelingen" → "8" "minimaal een 7" → "7" "score van 9+" → "9" "reviews maken niet uit" → "none" "goed hotel" → {}
6789noneregionarrayroomarrayRoom composition as `adults_children_babies` strings. Age groups: adults (18+), children (2-17), babies (0-1). Default: "2_0_0". When only kids/babies mentioned, keep 2 adults. Do NOT use for room types ("familiekamer"), hotel policies ("adults only"), negations ("geen kinderen"), or bedroom count ("2 slaapkamers"). Examples: "solo trip" → ["1_0_0"] "2 adults and 2 kids" → ["2_2_0"] "met een baby" → ["2_0_1"] "moeder en dochter" → ["1_1_0"] "2 slaapkamers" → {} "familiekamer" → {} "adults only" → {}
['2_0_0']starsarrayOfficial hotel star classification (1-5). Examples: "5 sterren" → ["5"] "3 of 4 sterren" → ["3", "4"] "minimaal 4 sterren" → ["4", "5"] "luxe resort" → ["5"] "goede beoordeling" → {}
transporttypearrayMode of travel to the destination. "VL" = flight "EV" = own transport Do NOT use for local mobility at destination, rental cars, or transfers. Examples: "vliegen naar Spanje" → ["VL"] "autovakantie Frankrijk" → ["EV"] "met de trein naar het vliegveld" → {} "transfer inbegrepen" → {}
trip_durationarrayTrip length in days at destination. Exact date ranges: count days inclusive ("18 tot 25 augustus" = 8 days). Convert nights to days: add 1 (3 nights = 4 days). Do NOT use for departure date ranges ("vertrek tussen 7 en 19 augustus" = when to go, not how long). Examples: "een week" → ["6", "7", "8", "9", "10"] "weekend" → ["2", "3", "4"] "10 tot 14 dagen" → ["10", "11", "12", "13", "14"] "18 tot 25 augustus" → ["8"] "3 nachten" → ["4"] "vertrek tussen 7 en 19 augustus" → {}